Gmail
 | Gmail is an email service provided by Google. With the Gmail app in , you can manage the emails, drafts, and attachments in your Gmail account. |
|---|
To use the Gmail app in , you must have a Gmail account.
's use and transfer of information received from Google APIs to any other app will adhere to Google API Services User Data Policy.
To connect an email ending in @gmail or @googlemail, you need to create a custom OAuth client in the Google Cloud Platform and get your project client credentials to establish the connection in .
There are two procedures to establish the connection in depending on credentials you provide:
- Default credentials provided by Make. Use this option if your company has a paid subscription to Google Cloud Platform and uses a custom domain name for Gmail: for example, [email protected]. Proceed to Create the connection in Make where you can skip step 3.
- Your custom credentials. You only have restricted access to Gmail API which doesn't allow using default credentials provided by . You need to create a custom OAuth client in Google Cloud Platform. Use this option if:
- You don't have a subscription to Google Cloud Platform, use a free Google Account, and have your email address ending with @gmail or @googlemail.
- You use a paid Google Account, and you want to have more control of what the Gmail app in is able to do. You need to gain 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. Proceed to create a custom OAuth client in Google Cloud Platform, and then Create the connection in Make where you need to follow all the steps.
To connect to using your own client credentials, you can create and configure a project in the Google Cloud Platform.
You need to follow the procedure if you use an email address that ends with @gmail or @googlemail.
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 the step 5.
Enter a Project name and select the Location for your project.
Click Create.
In the top menu, check if your new project is selected in the Select a project dropdown. If not, select the project you just created.
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.
To enable the required APIs:
Open the left navigation menu and go to 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.
To configure your OAuth consent screen:
In the left sidebar, click Google Auth Platform.
If you don't see Google Auth Platform in the left sidebar, click View all products at the top of it, then pin Google Auth Platform to the sidebar.
Click Get Started.
In the Overview section, under App information, enter Make as the app name and provide your Gmail address. Click Next.
Under Audience, select External. 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 User Data Policy.
Click Continue > Create.
Click Create OAuth Client.
In the Branding section, under Authorized domains, 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.
In the Data Access section, click Add or remove scopes, add the following scopes:
https://www.googleapis.com/auth/userinfo.email
https://mail.google.com
You can add scopes using:
- A table with filters
- A window to manually enter scopes:
Click Update.
Click Save.
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.
To create your client credentials:
In Google Auth Platform, click Clients.
Click + Create Client.
In the Application type dropdown, select Web application.
Update the Name of your OAuth client. This will help you identify it in the platform.
In the Authorized redirect URIs section, click + Add URI and enter the following redirect URI:
https://www.integromat.com/oauth/cb/google-restricted
Click Create.
Click the OAuth 2.0 Client you created, copy your Client ID and Client secret values, and store them in a safe place.
You will use these values in the Client ID and Client Secret fields in .
Log in to your account, add a Gmail module to your , and click Create a connection.
Optional: In the Connection name field, enter a name for the connection.
Optional for Gmail users with non-@gmail or @googlemail domains: Switch on the Show advanced settings toggle and enter your Client ID and Client secret that you created in the previous section. For more information, see the Create and configure a Google Cloud Platform project for Gmail 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 . If you want to make changes to your connection in the future, follow the steps here.
You can look for Gmail templates in Make's template gallery, where you'll find thousands of pre-created .