In this tutorial, let's set up Talon.One and Iterable to have Iterable automatically request user-specific coupon codes directly from Talon.One.
For example, let's imagine that:
- We are sending an email to users in some segment.
- We want to include user-specific coupon codes worth 10% off purchases over $20.
With this integration, you can automate the process of creating those coupon codes via Talon.One and displaying them in the promotional email from Iterable.
This tutorial also applies when you want to create gift cards with Iterable. You can apply the same steps because gift cards are a special type of coupons.
Contact your Iterable CSM for implementation support.
You can modify the shape of Talon.One-generated coupon codes for any campaign:
- Open your campaign.
- Click Settings > Coupon codes.
Let's generate a Talon.One API key that we will use for a 3rd-party service, in our case, Iterable.
- Navigate to the developer settings of your Talon.One Application.
- Click Create API Key
- For Do you want to use this API Key with a 3rd party service?, select Yes.
- Select Iterable from the dropdown.
- Select and expiry date and click Create API Key.
- Copy it for later use.
To generate the coupon in Iterable, we call the following endpoint:
https://integration.talon.one/iterable?&deployment=[deployment] &applicationId=[applicationID] &campaignId=[campaignID] &discountLimit=[discountLimit] &usageLimit=[usageLimit] &startDate=[startTime] &expiryDate=[expiryTime] &recipientintegrationid=[recipientIntegrationID]
With the following query parameters:
- deployment*: Your deployment base URL. For example, if your Talon.One
dashboard URL is
demo123.talon.onethen this will be
- applicationID*: The ID of your app.
- campaignID*: The ID of the campaign in which the coupon should be granted.
- discountLimit: The discount amount the coupon is worth. Can be blank if for example the coupon provides a 10% discount or something other than a set value of discounts.
- usageLimit: The number of times the coupon can be used.
- startTime: The URL-encoded time at which the coupon becomes available.
- expiryTime: The URL-encoded time at which the coupon expires.
- recipientIntegrationID: The ID of the user to whom the coupon is being granted, if user-specific.
Generate the URI with the follow form:
You can now use this URI to configure Iterable.
In Iterable, create a new data feed to pull in coupon codes:
- Choose a name, for example
Talon.One coupon codes.
- Using the URI generated in the previous section in the URL field and
set Format to
- In HTTP Headers, type APIKey-v1 and enter your the API generated earlier.
Create an Iterable template that will be used for your marketing campaign
In the Advanced Options tab, select your Talon.One data feed.
For more information about data feeds, see the Iterable docs.
Reference the coupon code and/or entire response from Talon.One within the email template by using square brackets.
See the Iterable Docs.
Check the template and placement of the data feed response by using the
Preview with datatool.
Load template feedin order to bring in the data feed response data into the template.