Skip to main content

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 Docs
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 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:

  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 Yes.
  4. Select Customer Data Platform from the dropdown.
  5. Select and expiry date and click Create API Key.
  6. Copy it for later use.

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

Authorization: ApiKey-v1 dbc644d33aa74d582bd9479c59e16f970fe13bf3

Update customer profile

To update a customer profile and change the audiences it is part of, use the following endpoint:

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

You can modify the shape of Talon.One-generated coupon codes for any campaign:

  1. Open your campaign.
  2. Click Settings > Coupon codes.

Create audience

To create an audience in Talon.One from a CDP, use the following endpoint:

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

Update audience

To update an audience in Talon.One from a CDP, use the following endpoint:

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

Delete audience

To delete an audience in Talon.One from a CDP, use the following endpoint:

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