Connecting Make to Google services using a custom OAuth client

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

Note

The following procedure is intended for:

  • Personal use (@gmail.com and @googlemail.com users)

  • Internal use (Google Workspace (formerly GSuite) users that prefer to use a custom OAuth client)

Prerequisites:

  • a Google account

Tip

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:

Note

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

For the Scopes section:

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

Scopes for Google APIs

Enter the required scopes for the Google service you want to connect to Make by checking the corresponding box for each required scope.

61d5ae78ae71f.gif

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:

Note

The Optional Info section is displayed only for non-Google Workspace users and does not contain any required fields.

Warning

This step is required, otherwise, you won't be able to establish a connection with Make.

Click Add users to add the email address associated with the Google account you want to connect to Make.

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

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

    61d5ae6b42059.gif
  3. Choose a name for your project, then click Create.

    61d5ae6d85f70.gif
  4. Click Enable APIs and services.

    61d5ae702f2f2.png
  5. In the Enable APIs and services field, enter the name of the service you want to use (for example, Gmail API or Google Drive API).

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

    61d5ae717fdd0.gif
  7. Click Enable.

    61d5ae74075d3.png
  8. Go to APIs & Services > OAuth consent screen settings, choose the External option, then click Create.

    61d5ae7557052.gif
  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, Make.

    User Support Email

    Select your email.

    Authorized domains

    integromat.com

    make.com

    Developer contact information

    Enter your email.

  10. Open the Credentials settings page.

    Note

    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 + Create credentials, and select the OAuth client ID option.

    61d5ae7b5df33.gif
  12. Fill in the required fields as follows, then click Create.

    Application type

    Web application

    Name

    e.g. Make

    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 Make Developer Platform

    OAuth redirect URI domain

    Notice that the redirect URI starts with https://www.integromat.com instead of https://www.make.com. This is currently a known issue in Make.

    Make was formerly called Integromat, which means you can trust this URL as much as any Make URL.

    61d5ae7dce0ef.png
  13. A dialog containing the app's Client ID and Client Secret is displayed.

    61d5ae7f28b5f.png
  14. Go to your Make scenario and choose the Google module you want to use.

  15. Next to Connection, click Add.

  16. Click Show advanced settings.

    61d5ae8029ea8.gif
  17. Enter the Client ID and Client Secret you retrieved in step 14 (above) to the respective fields, then click Continue.

  18. Sign in with your Google account.

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

    Note

    The app = your OAuth client you have created above.

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

    61d5ae8219fac.gif
  20. Click Allow to grant Make permission.

    61d5ae8413938.png
  21. Click Allow to confirm your choices.

    61d5ae8512ad8.png

You have now established the connection to the desired Google service using a custom OAuth client.

Common Problems

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

If this error message appears, you need to enable the corresponding API in your Google Cloud Platform.

61d5ae8624010.png

To enable the API, follow the steps described above.Enable APIs

61d5ae8733e63.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 Make 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 Add users to add a test user. Enter the email address associated with the Google account you want to connect with Make, and click Save.

    61d5ae88bf8bf.gif
  4. Now, go to Make, and connect to the desired Google service.

Your connection has expired and is no longer valid. You need to reauthorize the connection.

This error affects non-Google Workspace accounts. For more details please refer to the Google OAuth documentation.

Solution

Reauthorize your Google connection by following these steps:

  1. Log in to Make.

  2. Go to Connections.

    61d5ae8b80aaa.png
  3. Find your Google connection and click Reauthorize button.

    61d5ae8ccf5cc.png

    Note

    To prevent the expiration of your Google connection, we suggest you to reauthorize the connection every week.