Set up a connection to Google Mail

Gmail documentation: API guide, Authentication

A. Set up a Google Mail connection

Start establishing a connection to Google Mail in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select Google Mail.

The Create connection pane opens with required and advanced settings.

B. Supply required Google Mail account information

At this point, you’re presented with a series of options for providing Google Mail authentication.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing. 

Configure scopes (required): Scopes are permissions that the Gmail API defines to limit the access to your account. To select the scopes for this connection,

1. Click the Configure scopes button.
2. To access all of the scopes in the API, click the » button.
       – or –
   Check the scopes you want to add, and click the > button.

Configure your client id and secret (required): Check this box to reveal iClient options.

iClient (required): Select the iClient pair that stores the client ID and client secret provided to you by Google Mail. To add an iClient and configure your credentials, click the plus (+) button. Click the edit ( ) button to modify a selected iClient. Be sure to give the iClient a recognizable name for use in any other connections.

Callback URL (read-only): Copy this integrator.io callback URL to provide directions to Google Mail for where to go after authentication. (This URL should be whitelisted with the authorization server.)

How to retrieve the Google Mail iClient pair & specify callback URL

Sign in to your Google API Console, and click Create project in your dashboard. 

Describe your project and click Create.

From the console options, select OAuth consent screen at the left. Create a consent screen for internal or external users. 

Set the Application type to Public, describe the application, and click Save. 

Then, select Credentials from the console options. In the Credentials page, click + Create credentials > OAuth client ID.

Describe the new client ID. Under its Authorized redirect URIs, paste the Callback URL above. When you click Create, you are shown the client ID and secret for use in the Google Mail connection’s iClient pair.

C. Edit advanced Google Mail settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Google Mail connection.

Borrow concurrency from (optional): Select another connection from the list....

Concurrency level (optional): Up to 25 allowed....

D. Test the connection

Once you have configured the Google Mail connection, you have a couple options for continuing:

• Save & authorize – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account (and applied to the current source or destination app, if you created it within a flow)
• Cancel – click to exit without saving any new changes

When you select Save & authorize, you are presented with a Google Mail form in a new browser window.

Caution: Depending on your browser history and the permissions you’ve granted, you may see the following screen when attempting to log in:

If so, click Advanced, and then click Go to integrator.io (unsafe) to allow the exception and continue.

After signing in, review the permissions for the integration and click Allow.

The browser window closes, and the new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.