# Gmail

Gmail (opens new window) is a popular email service used by both consumers and businesses alike.

The Gmail connector enables you to build powerful automation around Gmail and connect with other applications.

# API version

This connector uses Gmail API v1 (opens new window).

# How to connect to Gmail on Workato

The Gmail connector uses OAuth 2.0 for authentication. When prompted, follow the on-screen connection instructions and login to your Google account to connect.

Based on Google's updated security policies, Gmail triggers or download attachment actions can only be used by paid G Suite accounts. Before you link your account, and if you intend to use the Gmail New email trigger or Download attachment action, you must add Workato's Gmail connector app to the allowlist, and grant it read permission. The following section will guide you through the required steps.

# Add Workato Gmail connector to the allowlist

Check out (opens new window) Google’s detailed instructions for managing OAuth-based access to connected apps. Below is a step-by-step guide for adding Workato Gmail Connector app for your GSuite account to the allowlist.

# Step 1. Login to the Admin Console of your Google Workspace

You must be signed in as a super administrator (opens new window) of your Google Workspace to complete the actions listed below.

Login to Google admin console Login to Admin Console of your Google Workspace

# Step 2. Navigate to the API controls in Security Settings

From the Admin console home, go to Security > API Controls. This might be located at the bottom of the page.

API permissions API Controls

# Step 3. Navigate to Manager Third-Party App Access

Select Trusted Apps Select Trusted Apps

Select "Configure new app" and "OAuth App Name Or Client ID" in the dropdown.

Trusted Apps Configure new app

Fill in the OAuth 2.0 Client ID for the Workato Gmail Connector.

763335457294-gp4359qrjgu7vl96eit0p2n725197oki.apps.googleusercontent.com

Fill in the OAuth 2.0 Client ID Fill in the OAuth 2.0 Client ID

Select the available OAuth client ID

Add to save changes Select the available OAuth client ID

Select the "Trusted" option for app access

Add to save changes Select trust level for the Workato app

Lastly, set Read email permission to Yes and select Link your account.

Select Yes for read email permission Select Yes for read email permission