On this page: Learn how to view, manage, and create API credential sets for custom channels in Adobe Journey Optimizer, so you can authenticate requests to your endpoint across different brands or environments without duplicating the channel.
When a custom channel is created with an authentication type other than None, an initial set of API credentials is automatically generated when the channel is activated.
You can view, manage and edit credentials from Administration > Channels > Channel builder > API credentials.
Having multiple credentials for the same channel lets you attach different authentication values to different channel configurations - for example, for different brands or use cases - without duplicating the channel definition.
To edit an existing set of credentials, click an item from the inventory list. All fields are editable.
To create additional credentials for the same channel, follow the steps below.
-
From the API credentials list, click Create API credentials.
-
Provide a name and description.
-
Select the Channel for which you are creating credentials.
note NOTE Only activated custom channels with an authentication type other than None display in the drop-down list. -
Select the Authentication type from the list.
-
Fill in the authentication-specific fields:
- API Key – Provide the key name, value, and location (query parameter or header).
- Basic auth – Provide a username and password.
- OAuth 2.0 – Configure the payload for OAuth 2.0 authentication. Learn more
-
Click Save.
Next steps next-steps
- Delegate a subdomain (optional — required for link tracking)
- Create a channel configuration
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to view, edits, and creates additional API credential sets for a custom channel so that requests to the endpoint can be authenticated across different brands or environments without duplicating the channel.
Intents:
- View and manage existing API credentials for a custom channel
- Edit the fields of an existing credential set
- Create additional credential sets for the same channel
- Attach different authentication values to different channel configurations
Glossary:
- API credentials: A named set of authentication values used to authenticate requests sent to a custom channel endpoint (product-specific)
- Authentication type: The method selected for a credential set, such as API Key, Basic auth, or OAuth 2.0 (product-specific)
- Channel configuration: The configuration to which a specific credential set can be attached (product-specific)
Guardrails:
- When a custom channel is created with an authentication type other than None, an initial set of API credentials is generated automatically when the channel is activated.
- Only activated custom channels with an authentication type other than None appear in the Channel drop-down when creating credentials.
- When editing an existing credential set, all fields are editable.
Terminology:
- Canonical name: API credentials — Acronym: n/a — variants: API credential set, credentials
- Synonyms: “credential set” = “set of API credentials”
- Do not confuse: “API credentials” (authentication values authenticating requests to the endpoint) ≠ “channel configuration” (the configuration to which different authentication values are attached)
FAQ:
- Q: Where do I manage API credentials? — Under Administration > Channels > Channel builder > API credentials.
- Q: Why create multiple credential sets for one channel? — To attach different authentication values to different channel configurations, for example for different brands or use cases, without duplicating the channel definition.
- Q: Which channels appear when I create credentials? — Only activated custom channels with an authentication type other than None.
- Q: Are credentials created automatically? — Yes, an initial set is generated automatically when a channel using authentication is activated.