Skip to main content

Generic CDP integration

You can integrate with any customer data platform (CDP) using Talon.One's endpoints for third-party tools.

important

These endpoints are for general use with any platform. If you use a partner listed in the Customer data platforms section, do not follow this tutorial. Instead, refer to a tutorial specific to your platform.

The following endpoints are available:

See API Docs

Authenticating​

All CDP endpoints rely on Talon.One's third-party API keys of type Customer Data Platform.

To generate an API key:

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

  2. Click Create API Key.

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

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

  7. From Platform, select Customer Data Platform.

  8. Click Create API Key.

  9. Click to copy the key for use.

    note

    You cannot view or copy the API key after closing the drawer. If you lose it, create another API key.

Use the key in the Authorization header of each of the endpoints. For example:

Authorization: ApiKey-v1 dbc644d33aa74d582bd9479c59e16f970fe13bf3

Updating a customer profile​

To update a customer profile and change its audiences from a CDP platform, use the following endpoint:

PUT Update customer profile
https://integration.talon.one/cdp/customer_profile/{customerProfileId}

See API Docs

Updating audiences in multiple customer profiles​

To update the audiences in multiple customer profiles from a CDP platform, use the following endpoint:

PUT Update audiences in multiple customer profiles
https://integration.talon.one/cdp/customer_profile/audiences

See API Docs

Creating an audience​

To create an audience from a CDP platform, use the following endpoint:

POST Create audience
https://integration.talon.one/cdp/audiences

See API Docs

Updating an audience​

To update an audience from a CDP platform, use the following endpoint:

PUT Update audience
https://integration.talon.one/cdp/audiences/{audienceId}

See API Docs

Deleting an audience​

To delete an audience from a CDP platform, use the following endpoint:

DELETE Delete audience
https://integration.talon.one/cdp/audiences/{audienceId}

See API Docs