Connecting to Gmail

Gmail is Google's free web-based email service that provides storage for emails, chat, and archiving.

To enable this integration, you must establish a secure connection that enables both platforms to communicate. See Managing connections for more details.

By default, Single sign-on (SSO) is disabled for your app. To enable it, refer to Configuring single sign-on for applications.

Connecting to Gmail using Key Value Pair

To connect watsonx Orchestrate to Gmail:

  1. From the main menu, go to Manage > Connections.

  2. Search for Gmail and locate the connection ID: google_key_value_ibm_184bdbd3

  3. Click edit next to the matching connection ID.

  4. Select the environment where you want to create the connection:

    • Draft: for testing and development
    • Live: for production use

  5. Set Authentication Type to Key Value Pair.

  6. Add the following keys and their respective values. Click Add new field to input each pair:

    Key Description
    base_url The base URL for Gmail API (for example, https://gmail.googleapis.com/)
    token_url The URL used to obtain the OAuth token (for example, https://oauth2.googleapis.com/token)
    client_id Your Google Cloud project's client ID
    client_secret Your Google Cloud project's client secret
    bearer_token The access token used for API requests
    refresh_token The token used to refresh the bearer token when it expires

    To get these values, see the Google Authentication API documentation.

  7. Choose the credential type. Only the team credentials are supported when an app is connected using the Key Value Pair authentication type.

  8. Click Save to complete the setup.

The icon A green check icon appears indicates that the connection was successfully established.