Connecting to Dun & Bradstreet for Sales

Edit online

Dun & Bradstreet (D&B) offers a suite of business intelligence solutions, including D&B for Sales, which provides sales teams with access to real-time company data, insights, and analytics to drive smarter prospecting and engagement.

To integrate Dun & Bradstreet for Sales 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 Connecting apps for prebuilt agents.

Important:

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

Steps to connect

Use the following steps to connect D&B for Sales to watsonx Orchestrate:

  1. Go to Manage > Connections and search for the corresponding app name or D&B for Sales Connection ID.

  2. Click edit next to the matching connection ID.

  3. Select the authentication method your organization uses (OAuth 2.0 or Key Value Pair).

  4. Enter the D&B for Sales‑specific fields based on the selected authentication method. See Connecting apps for prebuilt agents page for general connection workflow.

  5. Complete the Draft and Live setup steps.

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

Supported authentication methods

D&B for Sales supports the following authentication types in watsonx Orchestrate:

  1. OAuth 2.0 (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, OAuth 2.0 is the only supported authentication for D&B.

Connection ID

Use the following Connection IDs when locating your D&B for Sales connection in the Connections settings page. To understand how to search for a Connection ID and open a connection for editing, see Connecting apps for prebuilt agents.

Authentication type

Connection ID

OAuth2 Authorization Code

dnb_sales_ibm_184bdbd3

Key Value Pair

dnb_sales_key_value_ibm_184bdbd3 (deprecated)

OAuth 2.0 connection details

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 Dun & Bradstreet for Sales 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 Dun & Bradstreet for Sales

To get these values, see the D&B Authentication API documentation.

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

client_id

Your D&B for Sales application’s client ID

client_secret

Your D&B for Sales application’s client secret

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

To get these values, see the D&B Authentication API documentation.

What to do next

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

  • Run an agent in Orchestrate Chat to complete tasks using natural language.

  • Use relevant tools to perform app-specific actions.