Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure API credentials for IBM watsonx

Configure your API credentials to use IBM watsonx Granite models in custom workflows and Virtual Agent Designer topics.

Before you begin

To use IBM watsonx large language models (LLMs), you must configure your credentials to use the Generative AI Controller capabilities.

Role required: admin

About this task

In order to use models with IBM watsonx as your LLM provider for Generative AI Controller capabilities, you must have an active connection configured.

Procedure

  1. Navigate to All > Connections & Credentials > Connections & Credential Aliases.

  2. Open the record named IBM watsonx.

  3. Select the Create New Connection & Credential related link.

Image omitted: gai-create-new-connection-ibm.png
Create New Connection & Credential related link highlighted on the screen.
  1. In the API key field, enter your API key.

    For more information about generating an API key, see IBM's documentation for generating API keys for authentication.

  2. Create a connection by selecting Create.

Result

You can now use capabilities labeled with IBM watson in Flow Designer, Virtual Agent Designer, and scripts like background scripts and business rules to create custom experiences with generative AI.

Image omitted: gai-created-connection-ibm.png
Complete connection for IBM watsonx.

What to do next

If you want to use generative AI capabilities through your MID Server, open the new Connection record, select the Use MID server check box, and save the record.