How to add a Gmail account


Follow these instructions to add your Gmail account to either an individual or shared inbox in Front. A Gmail account is an email account that you or your team can log into using a password.

How it works

  • Front will give you the option to import 50k of your most recent email messages if you choose to. See Step 5 of the instructions below for this option. You can find more details on Gmail import behavior here.
  • Front has two-way sync with Gmail accounts. More Gmail sync behavior here and exceptions here.
  • All Gmail labels will be converted into tags and applied to the conversation. The tags will be private or shared depending on if you added your Gmail account to an individual inbox or a shared inbox.
  • By default, any Gmail account that is added to Front will have the threading mode set to Gmail threading. For more information on Gmail threading and other threading options, see here.

How to prepare your inbox before adding it to Front

To ensure your transition to Front goes smoothly, prepare your inbox using the following best practices. Use the method below differentiate the historical emails that still require your action, so that you'll know which conversations to work on after adding your inbox to Front.

  • Before adding your inbox to Front, create a unique Gmail label and apply it to the relevant conversations.
  • Follow the steps from the Instructions section below to add your inbox to Front.
  • After you've successfully added your Gmail account and imported your history, follow these next steps. The steps will differ based on if you added an individual inbox or a shared inbox.
    • If you added a Gmail account to an individual inbox:
      • Mass archive all conversations before the current date by following the steps here.
      • Once you’ve archived your entire inbox, navigate back to your inbox. Click into the search bar and use the tag: search modifier to search for all email conversations that have your unique Gmail label.
      • Mass select the conversations, tag them with the private Inbox tag, then unarchive them.
    • If you added a Gmail account to a shared inbox:
      • All emails will be automatically archived by default.
      • Navigate back to your inbox. Click into the search bar and use the tag: search modifier to search for all email conversations that have your unique Gmail label.
      • Mass select the conversations and unarchive them.


Step 1

Click the gear icon on the top right of Front and into the Company or Personal settings tab, depending on which space you are working with. Admins can also access user settings by following these steps.

Step 2

Click on Inboxes on the left menu and Add an individual inbox or Add a shared inbox, depending on which space you're in. Fill out the name and description of your inbox and click Create.

Step 3

Choose Google from the channel menu, then select Gmail Account, and click Continue.

Step 4

Click the blue Sign in with Google button to authenticate with your credentials. Front requires full Read and Write access to Gmail accounts. Click Allow to grant Front these permissions. For reference, these are the permissions that Gmail lists:

  • Read, compose, send, and permanently delete all your email in Gmail
  • View and manage the provisioning of calendar resources on your domain
  • See, edit, share, and permanently delete all the calendars you can access using Google Calendar

Note: Though the first permission states that Front needs permission to permanently delete your email in Gmail, Front actually does not have access to and will not permanently delete your emails in Gmail. Front is only able to permanently delete from our own servers. Learn more about how Front permanently deletes here.

Step 5 

You will see a screen titled Import.

Here, you can:

  • Choose whether or not to import all historical conversations
  • Choose whether or not to import and sync all labels

If you do not wish to import these items turn the toggles off so they appear greyed out. See here for additional details regarding the email history import.

Step 6 (for shared inbox)

Choose the teammate access for this inbox,  and whether you'd like to automatically add this inbox to their sidebars.

Step 7

Complete the remainder of the inbox settings, and click Finish.


How will Front sync with Gmail?

Check out the full breakdown here.

Why is archiving not syncing?

There are instances where the sync will stop due to actions or settings that you have in Front. Learn what those actions are that will stop archive sync between Gmail and Front.

How many emails get imported into Front?

Once you connect your Gmail account, Front will automatically import 50K of your most recent emails from the inbox.

Where are my labeled emails?

For Gmail accounts connected to individual inboxes, emails labeled in Gmail and imported into Front via the Gmail history import will not be visible in your Inbox tab. You can find these emails by viewing the corresponding Front tag.

To make these emails visible in your Inbox tab, add the private Inbox tag to the Front conversations.

I'm receiving an "admin_policy_enforced" error, what do I do?

This means that your Google Workspace App Access Control settings are restricted in a way that prevents Front from properly accessing your accounts.  Google documents these settings here:

There are two primary ways to fix this error which require access to your Google Workspace Admin Console.  Start by going to your Admin settings, then select Security, then App access control.

The first way is to remove restrictions on all Google Services:

Start by clicking Manage Google Services, then select all services and then click Change access. Select Unrestricted and then Change.

Alternatively, you can add Front as a Trusted app, giving access to all services:

From App access control, click on Manage third-party app access. Click Configure a new app then OAuth App Name or Client ID

Search for Front or the ID 754490832836, then Select the Front app from the list. Check the boxes for the OAuth Client ID and click Select

For App Access, select Trusted: Can access all Google services and finally Configure.


This feature is available on all plans.

Related Gmail Articles

6 replies

    • Adam
    • 5 yrs ago
    • Reported - view

    Hey - Front is not recognising my new gmail account. Does it take some time to be able to detect it as gmail?

    • front
    • 5 yrs ago
    • Reported - view


    No, it shouldn't take any time. Can you email us and we'll take a look at your account?


    • Joe_Lemay
    • 5 yrs ago
    • Reported - view

    It'd be great to use front app individual inbox to manage my personal email. My company uses gmail. But the problem is that when I set up an individual inbox in front app, it throws everything together and doesn't separate primary from updates, promotions, etc. is there a way to mange only my primary or separate these inboxed when I manage in front?

    • front
    • 5 yrs ago
    • Reported - view

    Joe Lemay Hi there,

    You could create rules to automatically add tags to the different types of emails. And you can make those tags noticeable in the second pane, so that you can quickly look over promotions. We're also getting ready to work on something called custom views, that will make this workflow even easier. Stay tuned for that announcement.

    • Elph_Morgan
    • 2 yrs ago
    • Reported - view

    Thanks for the section on "admin_policy_enforced" but the recommended actions don't match the Google Admin interface... at least for the business Google Suite. Is there perhaps a way to add Domain-wide Delegation for Front?

    • Tooling & Support Engineer
    • Evan_Ostroski
    • 2 yrs ago
    • Reported - view

    Elph Morgan I've updated that section of our documentation to more correctly reflect the settings in API controls.  Unfortunately, we're not able to support Domain-wide Delegation at this time.

    Please contact if you have any additional questions!