Integromat
  • Back to website
Articles in this section
  • Airtable
  • Bubble
  • Email (legacy)
  • Facebook Groups
  • Formstack
  • Google Cloud Vision
  • Google Sheets (legacy)
  • HTTP
  • JSON
  • Magento 2
See more
  1. Integromat Support
  2. Apps
  3. Docs

Connecting Integromat To Google Services Using a Custom OAuth Client

Integromat Support Team Integromat Support Team Updated January 14, 2021 11:27

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, like 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 step-by-step text-based guide, please watch 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.

gZ7YAZUebN.gif

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

SfAq1o84K8.gif

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.

IfuoYatgIX.gif

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. Go to APIs & Services > OAuth consent screen settings, choose the External option, and click the CREATE button.

PclXt3fhIB.gif

 

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

9. Fill in the required fields as follows:

For OAuth consent screen section:

Application name

Enter the name of the app asking for consent.

For example: Integromat.

User Support Email

Select your email.

Authorized domains integromat.com
Developer contact information Enter your email.

For the Scopes section:

Click the Add or Remove Scopes button to add required scopes.

Scopes for Google APIs

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

M2cXJpxIbq.gif

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

For the Test Users section (if you are using a GSuite account under an organization):

The Optional Info section is displayed only for non-GSuite users and does not contain any required fields.
This step is required, otherwise you won't be able to establish a connection with Integromat.

Click the ADD USERS button to add the email address associated with the Google account you want to connect with Integromat.

10. 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 previously.

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

UI5xuJoIUv.gif

12. Fill in 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/google-custom
    (for Google Text-to-Speech)
  • https://www.integromat.com/oauth/cb/app
    (for any 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

13. 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

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

ftkBPidLmh.gif

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

16. Sign in with your Google account.

17. 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.

IIthSk8IWb.gif

18. Click Allow to grant Integromat permission.

2020-05-26_15_28_34-Sign_in_-_Google_Accounts.png

19. Click the Allow button to confirm your choices.

2020-05-26_15_29_48-Sign_in_-_Google_Accounts.png

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.

mceclip0.png

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

Authorization Error - Error 403: access_denied

image.png

Google has added the required settings for the Consent screen. You'll need to add the email address associated with the Google account you want to connect with Integromat as a Test user.

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

2. Go to APIs & Services > OAuth consent screen.

3. In the Test Users section, click the ADD USERS button to add a test user. Enter the email address associated with the Google account you want to connect with Integromat, and click Save.

S4tRicdgTq.gif

4. Now, go to Integromat, and connect to the desired Google service.

 

Was this article helpful?
98 out of 112 found this helpful
Menu
  • Features
  • Apps & Services
  • Templates
  • Pricing
  • What's new
  • Use cases
Information
  • Terms,  Privacy
  • FAQ
  • Help & Tutorials
  • Community
  • Affiliate Program
  • Blog
Developers
  • Developer Platform
Company
  • About the company
  • Join our team
  • Contact
Follow us
© 2020 Integromat by Celonis. All rights reserved. Integromat® is a registered trademark.
  • English