# Gmail

Fast, searchable email with less spam.

## Overview

Use the Tray Gmail connector to list, send and download emails as well as change system preferences.

## API Information

The Gmail connector has the following Base URL: **<https://www.googleapis.com/gmail/v1>**. More information can be found on their main [API documentation (v1)](https://developers.google.com/gmail/api) site. Details regarding their API limitations can be found [here](https://developers.google.com/gmail/api/reference/quota).

## Authentication

> **Info:** Before authenticating this Google connector, you will need to whitelist the Tray Google authentication app. Please follow the instructions [here](https://tray.ai/documentation/platform/connectivity/authenticating-google-connectors/) before continuing with the authentication process.
> Also note that the connector does not support personal gmail accounts. You should have a [gmail for business](https://workspace.google.com/intl/en_in/lp/gmail/)

Once this is done, click the **Create new authentication** button:
![add-auth](https://tray.ai/documentation/images/connectors/service/gmail/4858a005-550b03d3_Gmail-auth-1.png)
Name your authentication and specify the type ('Personal' or 'Organizational').
![google-scopes](https://tray.ai/documentation/images/connectors/service/gmail/4858a005-04905890_Gmail-auth-2.png)
The next page will prompt you to enter your **Service account email**, **Private key** and \*\*Subject email. \*\* These fields are required only if you are using the **Send-as Alias** operation in the Gmail connector.
Next, ensure you set appropriate Service Permissions for your project scopes and then click **Create Authentication**.
![accept-google](https://tray.ai/documentation/images/connectors/service/gmail/4858a005-5df73a52_Gmail-auth-3.png)
Once redirected to Google, click on the **Allow** button to permit Tray to access your Google account.
![Gmail-auth-4](https://tray.ai/documentation/images/connectors/service/gmail/3Kaw82a34vnl6W3vHnZA4r_Gmail-auth-4.png)
Once done go back to your authentication field (within the workflow dashboard properties panel from earlier), and select the recently added authentication from the dropdown options now available.
This should validate and you will now be authenticated.
