---
title: "How to get your OAuth 2 credentials for Gmail"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_get_your_oauth_2_credentials_for_gmail-icon.svg
date: 2024-06-25T00:00:00.000Z
tag: Guides
description: "To access Google services such as Gmail (also known as Google Mail) through the Unified API, you'll generate and retrieve your OAuth 2 credentials in the..."
url: "https://docs.unified.to/guides/how_to_get_your_oauth_2_credentials_for_gmail"
---

# How to get your OAuth 2 credentials for Gmail
------
_June 25, 2024_

_Last updated: May 2026_


To access Google services such as Gmail (also known as Google Mail) through the [Unified API](https://unified.to/technology), you'll generate and retrieve your [OAuth](https://unified.to/embeddedauth) 2 credentials in the Google Cloud Console, then enter them in Unified.to.


## Create or select a project on Google Cloud Console

1. Navigate to the [Google Cloud Console](https://console.cloud.google.com/).
2. From the top nav bar, select an existing project or create a new one.
    - If creating a new project, name it whatever you want and click **Create**.

![Screenshot_2024-09-09_at_9.56.18_PM.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_get_your_oauth_2_credentials_for_gmail-0.png)


## Enable the Gmail API

1. With your project selected, open the left sidebar and navigate to **APIs & Services > Library** (or search for **Library** from the top nav bar).
2. Search for **Gmail API** and click the matching result.
3. Click **Enable**.

## Configure your OAuth consent screen


Google requires you to configure the OAuth consent screen before it will let you create an OAuth client ID. The consent screen is what users see when they grant your app access to their Gmail.

1. Open the left sidebar and navigate to **APIs & Services > OAuth consent screen**.
2. Choose the user type:
    - **Internal** — for Google Workspace organization-internal apps.
    - **External** — for consumer Gmail accounts or public apps.
3. Fill in the required fields: app name, user support email, and developer contact information (and, for production, your authorized domains).
4. Complete the consent screen setup.

## Get your OAuth 2 credentials

1. Navigate to **APIs & Services > Credentials** (or search for **Credentials** from the top nav bar).
2. Click **Create Credentials** and select **OAuth client ID**.
3. Select **Web application** as the application type, and name your app whatever you want.
4. Under **Authorized redirect URIs**, enter `https://api.unified.to/oauth/code` (or the corresponding EU/AU regional URL if your workspace is hosted there).
5. Click **Create**.
6. A dialog will appear displaying your new **Client ID** and **Client Secret**. Copy both — you'll need them for the next step.
> Store your Client Secret securely. Never commit it to source control or include it in client-side code; keep it in environment variables or a secrets manager.

## Activate Gmail in Unified.to

1. Navigate to the [Gmail integration page on Unified.to](https://app.unified.to/integrations/googlemail).
2. On the **Authorization** tab, with **OAuth 2** selected as the authentication method, enter your **Client ID** and **Client Secret**.
3. Click **Update** to save your changes and activate the Gmail integration.

## Set your OAuth 2 reauthentication policy


If you're connecting a **Google Workspace** account, make sure your reauthentication policy is set correctly for the integration to keep functioning. This step requires Google Workspace admin access and doesn't apply to consumer Gmail accounts.

1. In the Google Workspace Admin Console, navigate to **Menu > Security > Access and data control > Google Cloud session control**.
2. On the left, select the organizational unit where you want to set the session length. For all users, select the top-level organizational unit. (An organizational unit initially inherits its parent's settings.)
3. Under **Reauthentication policy**, select **Never require reauthentication**.

![Untitled.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_get_your_oauth_2_credentials_for_gmail-1.png)


You can now use the Unified API to build new experiences with Gmail. Happy building!


→ [Start your 30-day free trial](https://app.unified.to/login)


→ [Book a demo](https://calendly.com/d/cph9-g8n-jzg/connect-with-unified)