Authorization

When you add a Gmail card to a flow for the first time, you'll be prompted to create a connection. Setting up a connection allows you to save your account information and reuse that connection the next time you build a flow with the connector.

Tip

Tip

You can create multiple connections and manage them from your Connections page.

To create a new connection from an Event or Action card:

  1. Click New Connection.

  2. Enter a Connection Nickname for your Google Workspace account. The nickname can be the actual name of the account or a generic nickname.

  1. In the OAuth window, enter your Google account and password information.

  2. On the card, authorize access to your Google account by clicking Allow.

Caution

You may experience intermittent connection outages when you create a new connection for the Gmail connector. Existing connections and flows that include Gmail connector event or action cards are not affected. See Gmail connection returning "This app is blocked" error message.

Guidance for account types and the Gmail connector

  • Only Google Workspace users can make proper connections for the Gmail connector.

  • If you are using a gmail.com or googlemail.com account, then connections for the Gmail connector will fail at runtime, Gmail connector cards will not function as intended, and flows that contain a Gmail card will not run successfully.

  • Project Service Accounts cannot be used to make connections for the Gmail connector.

  • Google Workspace users do not need to be assigned the role of Service Account User in their project to make a working connection for the Gmail connector and use these cards:

    • Read Email

    • Send Email

    • Send Email with Attachment

  • Google Workspace users must be assigned the role of Service Account User in their project to use these cards:

    • Add Delegate

    • Forward Emails

    • Set Auto Reply

    • Update User Gmail Settings

  • When using Google Sign In with the Okta Browser Plugin inside Workflows, you cannot switch accounts without first switching the account that's using the Okta Browser Plugin.

Supported Scopes

  • https://www.googleapis.com/auth/userinfo.profile

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

  • openid

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

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

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

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

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

Disclaimer Statement

The app’s use and transfer to any other app of information received from Google APIs will adhere to Google API Services User Data Policy, including the Limited Use requirements.

For Okta's policy on data privacy and practices, see Okta Privacy Policy.