---
title: Gmail (Legacy)
slug: gmail-legacy
image: https://make-cxp-documentation.ams3.cdn.digitaloceanspaces.com/apps-center-icons/PREVIEW_DEFAULT.png
createdAt: 2025-02-03T13:28:28.552Z
---

::::VerticalSplit{layout="left"}
:::VerticalSplitItem
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/rrFarobIWdrIFMzKbu99L-20251008-124840.png" size="50" width="800" height="800" position="center" showCaption="false"}
:::

:::VerticalSplitItem
Gmail is an email service provided by Google. With the Gmail (Legacy) app in Make, you can manage the emails, drafts, and attachments in your Gmail account.
:::
::::

:::hint{type="success"}
Make now offers a new [Gmail app](https://apps.make.com/google-email) that provides some module updates and simplifies the setup. Unlike the legacy version, it doesn't require creating a Google Cloud Platform project and OAuth credentials for personal Gmail accounts.

See [here](https://help.make.com/update-legacy-modules-with-new-modules) how to update legacy modules with new modules.
:::

# Requirements

To use the Gmail (Legacy) app in Make, you must have a [Gmail account](https://myaccount.google.com/).&#x20;

:::hint{type="info"}
Make's use and transfer of information received from Google APIs to any other app will adhere to [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy).
:::

# Connect Gmail (Legacy) and Make&#x20;

:::hint{type="info"}
To connect an email ending in `@gmail` or `@googlemail`, you need to [create a custom OAuth client](https://apps.make.com/gmail-legacy#create-and-configure-a-google-cloud-platform-proje) in the Google Cloud Platform and get your project client credentials to establish the connection in Make.
:::

There are two procedures to establish the connection in Make depending on credentials you provide:

1. **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, `yourname@yourcompanyname.com`. Proceed to [Create the connection in Make](https://apps.make.com/gmail-legacy#create-the-connection-in) where you can skip step 3.
2. **Your custom credentials.** You only have restricted access to Gmail API which doesn't allow using default credentials provided by Make. You need to create a [custom OAuth client in Google Cloud Platform](https://apps.make.com/gmail-legacy#create-and-configure-a-google-cloud-platform-proje). 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 Make 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](https://apps.make.com/gmail-legacy#create-and-configure-a-google-cloud-platform-proje) in Google Cloud Platform, and then [Create the connection in Make](https://apps.make.com/gmail-legacy#create-the-connection-in) where you need to follow all the steps.

## Create and configure a Google Cloud Platform project for Gmail

To connect to Make using your own client credentials, you can create and configure a project in the Google Cloud Platform.

:::hint{type="info"}
You need to follow the procedure if you use an email address that ends with `@gmail` or `@googlemail`.
:::

### Create a Google Cloud Platform project for Gmail

To create a Google Cloud Platform project:

::::WorkflowBlock
:::WorkflowBlockItem
Log in to the [Google Cloud Platform](https://console.cloud.google.com/) using your Google credentials.
:::

:::WorkflowBlockItem
On the welcome page, click **Create or select a project** > **New project**. If you already have a project, proceed to the [step 5](#).

::Image[]{src="https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-Oa9SL8PSb5oLdpaYe6goL-20250312-113144.png" size="70" width="626" height="189" position="flex-start" alt="Google Cloud Platofrm" showCaption="false"}
:::

:::WorkflowBlockItem
Enter a **Project name** and select the **Location** for your project.
:::

:::WorkflowBlockItem
Click **Create**.

![Select a project](https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-I7LwD3Eqxo8A1xGdNU00F-20250312-113236.png)
:::

:::WorkflowBlockItem
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.
:::
::::

:::hint{type="info"}
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:

::::WorkflowBlock
:::WorkflowBlockItem
Open the left navigation menu and go to **APIs & Services** > **Library**.
:::

:::WorkflowBlockItem
Search for the following API: **Gmail API**

![Gmail API](https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-REmWXs0paliNZ3UaoQFUy-20250312-113349.png)
:::

:::WorkflowBlockItem
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.
:::
::::

### Configure your OAuth consent screen for Gmail

To configure your OAuth consent screen:

::::WorkflowBlock
:::WorkflowBlockItem
In the left sidebar, click **Google Auth Platform**.

If you don't see **Google Auth Platform i**n the left sidebar, click **View all products&#x20;**&#x61;t the top of it, then pin **Google Auth Platform&#x20;**&#x74;o the sidebar.
:::

:::WorkflowBlockItem
Click **Get Started**.
:::

:::WorkflowBlockItem
In the **Overview** section, under **App information**, enter *Make* as the app name and provide your Gmail address. Click **Next**.
:::

:::WorkflowBlockItem
Under **Audience**, select **External**. Click **Next**.

For more information regarding user types, refer to [Google's Exceptions to verification requirements documentation](https://support.google.com/cloud/answer/9110914#exceptions-ver-reqts).
:::

:::WorkflowBlockItem
Under **Contact Information**, enter your Gmail address and click **Next**.
:::

:::WorkflowBlockItem
Under **Finish**, agree to the Google User Data Policy.
:::

:::WorkflowBlockItem
Click **Continue** > **Create**.
:::

:::WorkflowBlockItem
Click **Create OAuth Client**.

![Create OAuth client](https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-pmJoicQVYOCcrygT-qn4X-20250312-113750.png)
:::

:::WorkflowBlockItem
In the **Branding** section, under **Authorized domains**, add `make.com` and `integromat.com`. Click **Save.**
:::

:::WorkflowBlockItem
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.
:::

:::WorkflowBlockItem
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**.
:::

:::WorkflowBlockItem
Click **Save**.
:::
::::

:::hint{type="info"}
**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](https://support.google.com/cloud/answer/13463073?authuser=1\&visit_id=638718595933013017-1855034908\&rd=1) 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](https://support.google.com/cloud/answer/10311615#zippy=).
:::

### Create your Gmail client credentials

To create your client credentials:

::::WorkflowBlock
:::WorkflowBlockItem
In Google Auth Platform, click **Clients**.
:::

:::WorkflowBlockItem
Click **+ Create Client**.

![Create Client](https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-_ZOZfMOLZTl5cfqsnn9Zk-20250312-114156.png)
:::

:::WorkflowBlockItem
In the **Application type** dropdown, select **Web application**.
:::

:::WorkflowBlockItem
Update the **Name** of your OAuth client. This will help you identify it in the platform.
:::

:::WorkflowBlockItem
In the **Authorized redirect URIs** section, click **+ Add URI** and enter the following redirect URI:

`https://www.integromat.com/oauth/cb/google-restricted`

![Authorize redirect URI](https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-QSYhZk-Gh3QqyhtTQKDQP-20250312-114442.png)
:::

:::WorkflowBlockItem
Click **Create**.
:::

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

### Create the connection in Make&#x20;

::::WorkflowBlock
:::WorkflowBlockItem
Log in to your Make account, add a Gmail module to your scenario, and click **Create a connection**.
:::

:::WorkflowBlockItem
Optional: In the **Connection name** field, enter a name for the connection.
:::

:::WorkflowBlockItem
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](https://apps.make.com/gmail-legacy#create-and-configure-a-google-cloud-platform-proje) section.
:::

:::WorkflowBlockItem
Click **Sign in with Google**.
:::

:::WorkflowBlockItem
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](https://help.make.com/connect-an-application#tN2pJ).

# Templates

You can look for Gmail templates in [Make's template gallery](https://www.make.com/en/templates), where you'll find thousands of pre-created scenarios.

# Gmail resources

- [Gmail API documentation](https://developers.google.com/gmail/api/reference/rest)

