Skip to main content

Managing Integration API keys

The API key contained in an Application allows you to authenticate with the Integration API to send and retrieve data to a specific Application.

note
  • To create an API key to use the Management API, see Managing Management API keys.
  • If the user who created an Integration API key is:
    • Disabled: The key can be used until it expires, and the user's email address is displayed.
    • Deleted: The key can be used until it expires, and the user's email address is no longer displayed.

Creating an Integration API key​

Depending on your integration type, you can create a generic API key or an API key specific to a third-party integration service.

Creating a generic API key​

Create a generic API key to use in your integration layer. This is the type of key to use for Integration API requests.

To create a generic API key:

  1. Open your Talon.One Application in the Campaign Manager and click Settings > Developer settings.

  2. Click Create API Key.

  3. For Do you want to use this API Key with a 3rd party service?, select No.

  4. Select an expiration date and click Create API Key.

  5. Copy the key for later use.

    note

    You cannot display the API key after this step. If you lose the value, create a new API key.

Creating an API key for a third-party service​

To use the Integration API from a supported third-party service, like a customer engagement platform, create a third-party key.

To create a third-party key specific to, for example, Braze:

  1. In your Talon.One Application, click Settings > Developer settings.
  2. Click Create API Key.
  3. For Do you want to use this API Key with a 3rd party service?, select Yes.
  4. From Platform, select Braze.
  5. Select an expiration date, and click Create API Key.
  6. Copy the key for later use.

    7. note
    You cannot display the API key after this step. If you lose the value, create a new API key.

Using an Integration API key​

To use your:

Deleting an API key​

Deleting an API key cannot be undone. The software that uses that key immediately loses access to the Integration API.

  1. Open your Talon.One Application in the Campaign Manager and click Settings > Developer settings.
  2. Click to delete the API key of your choice.