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 connectionsfor more details.

Important: 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.

    Note: 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.

Note: The icon A Supports appears indicates that the connection was successfully established.