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 data to and retrieve it from a specific Application.

Looking for a different API?
note

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.

Integration API key types

Talon.One allows you to create and manage the following types of Integration API keys:

Key typeDescription
ProductionFor use in your integration layer for your production Applications. See the Authentication section of the Integration API docs.
Testing
Feature access

This key type is available only if campaign staging and revisions is enabled.

note

You can create only one key of this type.

For use in your staging environment. The key triggers all Staged and Running campaigns in the Application. If a Revised campaign exists, the key triggers it instead of the active campaign.
See Revising campaigns.

All requests made using the key are dry requests, and making production requests with it is not possible. The key allows access to the following endpoints:

API key states

API keys have the following states:

  • Valid: The key is valid and can be used.
  • Expires Soon: The key is valid and can be used but expires sometime in the next seven days.
  • Expired: They key has passed its expiration date and can no longer be used.

Creating a production API key

Create a production API key to use in your integration layer. This is the type of key to use for Integration API requests for the campaigns you manage in a production environment.

To create a production API key:

  1. In your Application, click Settings > Integration API Keys.

  2. Click Create API Key.

  3. In the Create API Key drawer, if you are asked for a key type, select Production.

  4. In Key name, type a name to identify the key.

  5. In Key expiration date, select a date.

  6. In Third-party integration, select No.

  7. Click Create API Key.

  8. Click to copy the key for use.

  9. note

    You cannot view or copy the API key after closing the drawer.

Creating a testing API key

Create a testing API key to test your Staged and Revised campaigns in your testing environment. You can create only one testing key in an Application.

Feature access

You can create and test using this key type only if campaign staging and revisions is enabled for your Application.

To create a testing API key:

  1. In your Application, click Settings > Integration API Keys.

  2. Click Create API Key.

  3. In the Create API Key drawer, select Testing as the key type.

  4. In Key name, type a name to identify the key.

  5. In Key expiration date, select a date.

  6. Click Create API Key.

  7. Click to copy the key for use.

  8. note

    You cannot view or copy the API key after closing the drawer.

Deleting an Integration API key

When you delete an Integration API key, the software that uses that key immediately loses access to the Integration API.

important

You cannot undo the deletion of an Integration API key.

To delete an Integration API key:

  1. In your Application, click Settings > Integration API Keys.
  2. In the API Keys section, to the right of the key you want to delete, click .
  3. In the confirmation window that appears, type the name of the key and click Delete API Key.