Create and configure a Google Cloud Platform project for Gmail
This section is optional and applies only if you're using your own Google Cloud Project client credentials, which requires switching on the Advanced settings toggle when creating the connection.
To connect to Make using your own client credentials, you need to create and configure a project in the Google Cloud Platform.
Create a Google Cloud Platform project for Gmail
To create a Google Cloud Platform project:
Log in to the Google Cloud Platform using your Google credentials.
On the welcome page, click Create or select a project > New project. If you already have a project, proceed to step 5 below.
Change the default Project name and Project ID, if needed. Select the Location for your project, and click Create.
On the top panel, next to the Google Cloud logo, click Select a project.
In the next window, click the project you just created.
You'll now see the Google Cloud Platform project you've created on the top panel, next to the Google Cloud logo.
To create a new project or work in the existing one, you need to have the serviceusage.services.enable permission. If you don’t have this permission, ask the Google Cloud Platform Project Owner or Project IAM Admin to grant it to you.
Enable APIs for Gmail
To enable the required APIs:
In the left sidebar of the Google Cloud Platform, click APIs & Services > Library.
Search for the following API: Gmail API
Click Gmail API, then click Enable.
If you see the Manage button instead of the Enable button, you can proceed to the next step: the API is already enabled.
Your API is now enabled.
Configure your OAuth consent screen for Gmail
If you are using an email address that ends with @gmail or @googlemail, your connection will expire after 6 months. To reauthorize your connection, click Reauthorize in the Connections section.
To configure your OAuth consent screen:
In the left sidebar of the Google Cloud Platform, click APIs & Services > OAuth consent screen.
Click Get Started.
In the Overview section:
- Under App information, enter Make as the app name, enter your Gmail address, and click Next.
- Under Audience, select External, and click Next. For more information regarding user types, refer to Google's Exceptions to verification requirements documentation.
- Under Contact Information, enter your Gmail address, and click Next.
- Under Finish, agree to the Google API Services User Data Policy, and click Continue, then Create.
- In the next window, click Create OAuth Client.
- You'll be redirected to the Clients tab. You can skip it for now or refer to the Create your client credentials section to configure it.
In the Branding section:
- Under Authorized domains, click +Add domain.
- Add make.com and integromat.com.
- Click Save.
Optional: In the Audience section, add your Gmail address on the Test users page, then click Save and continue if you want the project to remain in the Testing publishing status. Read the note below to learn more about the publishing status.
Publishing Status
Testing: If you keep your project in the Testing status, you will be required to reauthorize your connection in Make every week. To avoid weekly reauthorization, update the project status to In production.
In production: If you update your project to the In production status, you will not be required to reauthorize the connection weekly. To update your project's status, go to the Google Auth Platform, the Audience section, and click Publish app. If you see the notice Needs verification, you can choose whether to go through the Google verification process for the app or to connect to your unverified app. Currently connecting to unverified apps works in Make, but we cannot guarantee the Google will allow connections to unverified apps for an indefinite period.
For more information regarding the publishing status, refer to the Publishing status section of Google's Setting up your OAuth consent screen help.
In the Data Access section, click Add or remove scopes, add the following scopes:
- https://www.googleapis.com/auth/gmail.modify
- https://www.googleapis.com/auth/gmail.readonly
- https://www.googleapis.com/auth/gmail.compose
- https://www.googleapis.com/auth/gmail.send
You can add scopes using:
- A table with filters
- A window to manually enter scopes:
Click Update.
Click Save.
Create your Gmail client credentials
To create your client credentials:
In the left sidebar of the Google Cloud Platform, click APIs & Services > OAuth consent screen.
Go to the Clients section, and click +Create client.
Under Create OAuth client ID:
- In the Application type dropdown, select Web application.
- In the Name field, update the name of your OAuth client. This will help you identify it in the console afterward.
Under the Authorized redirect URIs, click + Add URI and enter the required redirect URI:
https://www.make.com/oauth/cb/google-email
Click Create.
You'll see a message that the OAuth client has been created. Copy your Client ID and Client secret values, and store them in a safe place. Click OK.
You will use these values in the Client ID and Client Secret fields in Make.
Create the connection in Make
Log in to your Make account, add a Gmail module to your scenario, and click Create a connection.
Optional: In the Connection name field, enter a name for the connection.
Switch on the Advanced settings toggle and enter your Client ID and Client secret that you created in the previous Create your client credentials section.
Click Sign in with Google.
If prompted, authenticate your account, grant all requested permissions, and confirm access.
You've successfully created the connection and can now use the Gmail app in your scenarios. If you want to make changes to your connection in the future, follow the steps here.