Connecting to Dropbox

Edit online

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 integrate Dropbox with IBM watsonx Orchestrate, you need to establish a secure connection that enables both systems to communicate seamlessly.

Note:

The single sign-on (SSO) toggle is enabled only for supported OAuth 2.0 authentication types and applications. If the application does not support an SSO-enabled authentication type, the toggle remains disabled. For supported configurations, see Configuring single sign-on for applications.

Steps to connect

Use the following steps to connect Dropbox to watsonx Orchestrate:

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

    Important:

    In the on-premises environment, use the Manage > Connections navigation path to access connections.

  2. Click the Connections tab and search for the corresponding app name or the Dropbox Connection ID.

  3. Click Edit next to the matching connection ID.

  4. Select the authentication method your organization uses.

  5. Enter the Dropbox‑specific fields based on the selected authentication method as described in the corresponding connection details section below.

  6. Complete the Draft and Live setup steps.

  7. Save and test the connection to confirm successful connection.

Authentication methods

Dropbox supports the following authentication types in watsonx Orchestrate:

  1. OAuth2 Authorization Code: Recommended for production connections

  2. Key Value Pair (KVP): Supported for API key–based and legacy scenarios

Note:

For agents created after September 2025, OAuth2 Authorization Code is the only supported authentication for Dropbox.

Connection ID

Use the following Connection IDs when locating your Dropbox connection in the Connections settings page.

Authentication type

Connection ID

OAuth2 Authorization Code

dropbox_ibm_184bdbd3

Key Value Pair

dropbox_key_value_ibm_184bdbd3 (deprecated)

OAuth2 Authorization Code

If your organization uses OAuth‑based authentication, set Authentication type to OAuth2 Authorization Code and enter the following fields:

Field

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.

Key Value Pair connection details

If your organization uses API keys or a legacy configuration, set Authentication type to Key Value Pair and add each of the following fields using Add new field:

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

Note: When using Key Value Pair, only Team credentials are supported.

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

What to do next

Now that your app connection is live, you can start using it in watsonx Orchestrate.