Scopes for Gmail connector cards

Your Gmail connector accesses the Google API using scoped OAuth 2.0 access tokens. Each access token enables the bearer to perform specific actions on specific Google endpoints. The scopes contained in the access token control the ability to perform these actions.

Grant the required scopes for each of the event and action cards that you want to use in your Google connector.

For an existing connection, you must reauthorize the connection to pick up any scope changes.

The OAuth 2.0 Scopes for Google APIs topic in the Google developer documentation contains detailed descriptions for all available scopes.

Event cards

The event cards for the Gmail connector require the scopes as indicated in the following table.

Connector card

Required scopes

Label Added or Removed

https://www.googleapis.com/auth/gmail.readonly

https://www.googleapis.com/auth/userinfo.email

New Email

https://www.googleapis.com/auth/gmail.readonly

https://www.googleapis.com/auth/userinfo.email

Action cards

The action cards for the Google Calendar connector require the scopes as indicated in the following table.

Connector card

Required scopes

Add Delegate

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Add Send-As Alias

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Custom API Action

Any scopes required by the API endpoint.

Delete Delegate

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Delete Send-As Alias

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Forward Emails

https://www.googleapis.com/auth/gmail.settings.sharing

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

List Delegates

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Read Email

https://www.googleapis.com/auth/gmail.readonly

https://www.googleapis.com/auth/userinfo.email

Search Emails

https://www.googleapis.com/auth/gmail.readonly

https://www.googleapis.com/auth/userinfo.email

Send Email

https://www.googleapis.com/auth/gmail.send

https://www.googleapis.com/auth/gmail.readonly

https://www.googleapis.com/auth/userinfo.email

Send Email with Attachment

https://www.googleapis.com/auth/gmail.send

https://www.googleapis.com/auth/gmail.readonly

https://www.googleapis.com/auth/userinfo.email

Set Auto Reply

https://www.googleapis.com/auth/gmail.settings.basic

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Update User Gmail Settings

https://www.googleapis.com/auth/cloud-platform

https://www.googleapis.com/auth/userinfo.email

Related topics

Gmail connector

Cards in flows

Gmail API documentation