Configure API credentials for IBM watsonx

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read

    • 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

    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.
    4. 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.

    5. 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.

    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.