Articles in this section

Connecting Integromat To Google Services Using a Custom OAuth Client

Integromat Support Team Updated September 29, 2020 19:23

In this article, we will show you how to create your own project in Google Cloud Console and a custom OAuth client. This is useful for connecting restricted Google services (e.g. Google Drive, or Gmail) to Integromat.

The following procedure is intended for:

Personal use (@gmail.com and @googlemail.com users)
Internal use (G Suite users that prefer to use a custom OAuth client)

Prerequisites:

a Google Account

If you prefer video over the text step-by-step guide, please check the following video tutorials:

Google Drive App - OAuth Setup Workflow

Gmail App - OAuth Setup Workflow

Follow these steps to create a custom OAuth client for Google services:

1. Sign in to Google Cloud Platform using your Google credentials.

2. Open the Dashboard and click the CREATE PROJECT button.

3. Enter the desired project name and click the CREATE button.

4. Click the ENABLE APIS AND SERVICES button.

2020-05-26_12_24_17-APIs___Services___APIs___Services___Custom_OAuth_Client___Google_API_Console.png

5. Type the name of the service you would like to use (for example Gmail API, or Google Drive API) in the Search for APIs & Services field.

6. The desired service option should display as you type. Click on the API/service you want to connect to Integromat.

7. Click the ENABLE button to enable the selected API.

2020-05-26_12_40_38-APIs___Services_-_Custom_OAuth_Client_-_Google_API_Console.png

8. Click on the CREATE CREDENTIALS button.

2020-05-26_12_48_41-Overview___APIs___Services___Custom_OAuth_Client___Google_API_Console.png

9. Open OAuth consent screen settings, choose the External option and click the CREATE button.

You will not be charged when selecting this option! For more details, please refer to Google's Exceptions to verification requirements.

10. Fill the required fields as follows and then click the Save button:

Application name

Enter the name of the app asking for consent.

For example: Integromat.

Scopes for Google APIs

Click the Add scope button to open the Add scope dialog.

Add required scopes for the Google service you want to connect to Integromat.

The list of required scopes:

SERVICE/API

REQUIRED SCOPES

Gmail

https://mail.google.com/
https://www.googleapis.com/auth/gmail.labels
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.compose
https://www.googleapis.com/auth/gmail.insert
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.metadata

Google Drive

https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly

Authorized domains integromat.com

You don't need to submit your consent screen and application for verification by Google. Just click the Save button after you fill the required fields on this page.

2020-07-16_09_52_55-Consent_screen_-_Google_OAuth_Client_-_Google_API_Console.png

11. Open the Credentials settings page.

If this is not the first API/SERVICE (Gmail or Google Drive) you have enabled, you don't have to create credentials, as you have already created the credentials before.

12. Click the +CREATE CREDENTIALS button and select the OAuth client ID option.

13. Fill the required fields as follows and then click the CREATE button to create the application:

Application type Web application

Name e.g. Integromat

Authorized redirect URIs

Add one of the following URIs:

https://www.integromat.com/oauth/cb/google-restricted
(For Gmail or Google Drive)
https://www.integromat.com/oauth/cb/google
(for other Google apps)
https://www.integromat.com/oauth/cb/app
(for the app created via the Integromat Developer Platform)

2020-05-26_16_24_10-Create_OAuth_client____APIs___Services___Custom_OAuth_Client___Google_API_Consol.png

14. A dialog containing the app's Client ID and Client Secret is displayed.

2020-05-26_14_43_28-Credentials___APIs___Services___Custom_OAuth_Client___Google_API_Console.png

15. Go to Integromat, open the Create a connection dialog of the desired Google module (e.g. Gmail or Google Drive) and open advanced settings by clicking the Show advanced settings checkbox.

16. Enter the Client ID and Client Secret you have retrieved in step 14 (above) to the respective fields and click Continue.

17. Sign in with your Google account.

18. The This app isn't verified window appears.

The app = your OAuth client you have created above.

Click on the Advanced link and then on the Go to Integromat (unsafe) link to allow access using your custom OAuth client.

19. Click Allow to grant Integromat permission.

20. Click the Allow button to confirm your choices.

Congratulations! The connection to the desired Google service using a custom OAuth client has been established.

Common Problems

100 Logins Limit Per Day Has Been Reached

This happens rarely, but when it does, we recommend creating another OAuth client.

[403] Access Not Configured

If this error message is displayed, you haven't enabled the corresponding API in your Google Cloud Platform.

To enable the API, please follow step 4, step 5, step 6, and step 7 as described above.

Was this article helpful?

77 out of 85 found this helpful