Connecting to Dropbox

Dropbox is a cloud-based file storage and collaboration platform that allows users to store, share, and access files securely across devices. Integrating Dropbox with IBM watsonx Orchestrate enables automated file management, synchronization, and workflow integration.

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 Dropbox using OAuth2

To connect watsonx Orchestrate to Dropbox using OAuth2:

  1. From the main menu, select Manage > Connections.

  2. Search for Dropbox.

  3. Locate the connection ID with the following format: dropbox_oauth2_auth_code_ibm_184bdbd3

  4. Click edit next to the matched connection ID.

  5. Choose the environment where the connection is used:

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

  6. Select OAuth2 Authorization Code as the Authentication Type.

  7. Provide the following keys and their respective values:

    Key Description
    Server URL Base URL of the Dropbox server
    Token URL Endpoint to exchange the authorization code for an access token
    Scope Defines what access is being requested
    Authorization URL URL where users are redirected to log in and authorize access
    Client ID Unique ID for your application
    Client Secret A secret key used to authenticate your app with Dropbox

    You can obtain these values from the Dropbox App Console. Refer to the Dropbox API documentation for more details.

  8. Choose the appropriate credential type.

  9. Click Save to complete the setup.

Connecting using Key Value Pair

  1. From the main menu, select Manage > Connections.

  2. Search for Dropbox.

  3. Locate the connection ID with the following format: dropbox_key_value_ibm_184bdbd3

  4. Click edit next to the matched connection ID.

  5. Choose the environment where the connection will be used:

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

  6. Select Key Value Pair as the authentication type.

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

    Key Description
    base_url The base URL for Dropbox API (for example, https://api.dropboxapi.com)
    token_url The URL used to obtain the OAuth token (for example, https://api.dropbox.com/oauth2/token)
    client_id Your Dropbox app’s client ID
    client_secret Your Dropbox app’s client secret
    bearer_token The access token used for authenticated API requests
    refresh_token The token used to refresh the bearer token when it expires

    You can obtain these values from the Dropbox App Console. Refer to the Dropbox API documentation for more details.

  8. Choose the appropriate credential type.

    Note: Only the team credentials are supported when an app is connected using the Key Value Pair authentication type.

  9. Click Save to complete the setup.

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