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.
Testing
Feature access

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

For use in your staging environment with Staged and Revised campaigns. This key type allows you to send only dry requests 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. If you lose it, create another API key.

Creating a testing API key​

Create a testing API key to test your Staged and Revised campaigns in your testing environment.

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. If you lose it, create another API key.

Using an Integration API key​

Use a production API key for integration as described in the Authentication section of the Integration API docs.

Use a testing API key in your staging environment. When you send requests to your Staged and Revised campaigns, the testing API key is automatically used for authentication.

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.