Connecting to Box

Box is a secure, cloud-based file-sharing and collaboration platform that enables teams to create, edit, and manage documents in real time—anytime, anywhere, and on any device.

To integrate Box with IBM watsonx Orchestrate, you need to establish a secure connection that enables both systems to communicate seamlessly. For general guidance on managing integrations, refer to Managing connections.

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

To connect watsonx Orchestrate to Box:

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

  2. Search for Box and locate the connection ID: box_oauth2_auth_code_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. Select Oauth2 Authorization Code as the Authentication type.

  6. Provide the following values:

    Key Description
    server_url The base URL of the Box API server
    authorization_url The URL where users are redirected to authorize access. For example, https://account.box.com/api/oauth2/authorize.
    token_url The endpoint used to exchange the authorization code for an access token. For example, https://api.box.com/oauth2/token.
    client_id Your Box app’s client ID from the Box Developer Console
    client_secret Your Box app’s client secret from the Box Developer Console

    To get these values, see the Box Authorization API documentation.

  7. Choose the appropriate credential type.

  8. Click Save to complete the setup.

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

Connecting to Box using Key Value Pair

To connect watsonx Orchestrate to Box:

Note: For agents deployed before September 2025, continue using existing connection types for Box integration. For agents created after September 2025, OAuth2 is the only supported authentication method for Box.

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

  2. Search for Box and locate the connection ID: box_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 Base URL of your Box API endpoint.
    token_url URL used to obtain the OAuth token. For example, https://api.box.com/oauth2/token.
    client_id Your Box application’s client ID
    client_secret Your Box application’s client secret
    subject_id The Box user or enterprise ID the app will act on behalf of
    subject_type Type of subject (for example, user or enterprise)

    To get these values, see the Box Authorization 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.