Generic CDP integration
You can integrate with any customer data platform, or CDP, using the following endpoints designed for 3rd-party tools, rather than your own integration layer.
The following endpoints are available:
See API DocsThese 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 but instead, refer to a tutorial specific to your platform.
Authenticating
All these endpoints rely on Talon.One's 3rd-party API keys of type Customer Data Platform
.
To generate one:
- In your Talon.One Application, click Settings > Developer settings.
- Click Create API Key.
- For Do you want to use this API Key with a 3rd party service?, select Yes.
- From Platform, select Customer Data Platform.
- Select an expiration date, and click Create API Key.
- Copy the key for later use.
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 the audiences it is part of, use the following endpoint:
https://integration.talon.one/cdp/customer_profile/{customerProfileId}
You can modify the shape of Talon.One-generated coupon codes for any campaign:
- Open your campaign.
- Click Settings > Coupon codes.
Creating an audience
To create an audience in Talon.One from a CDP, use the following endpoint:
https://integration.talon.one/cdp/audiences
Updating an audience
To update an audience in Talon.One from a CDP, use the following endpoint:
https://integration.talon.one/cdp/audiences/{audienceId}
Deleting an audience
To delete an audience in Talon.One from a CDP, use the following endpoint:
https://integration.talon.one/cdp/audiences/{audienceId}