Skip to main content

Creating coupons via Iterable

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.


If you're not using Iterable, see the generic customer engagement platform docs.

Rate limiting recommendations

Contact your Iterable CSM for implementation support.

Talon.One coupon settings

You can edit the default format of the coupon codes in the campaign's Settings section.

Creating 3rd-party API key

Let's generate a Talon.One API key that we will use for a 3rd-party service, in our case, Iterable.

  1. In your Talon.One Application, 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. From Platform, select Iterable.

  5. Select an expiration date, and click Create API Key.

  6. Copy the key for later use.


    You cannot display the API key after this step. If you lose the value, create a new API key.

The integration endpoint for coupons

To generate the coupon in Iterable, we call the following endpoint:

GET create coupon

See API Docs

Generating the URI

Generate the URI with the following form.

  • You can use Iterable field values in the URI using the {{my_field_value}} notation, for example &recipientIntegrationID={{id}}.
  • Iterable supports campaign-related merge parameters, such as {{campaignId}} and {{campaignName}}, which are generated at campaign send time.

You can now use this URI inside Iterable.

Configuring Iterable

Creating the data feed

In Iterable, create a new data feed to pull in coupon codes:

  1. Click Content > Data Feeds > Create New Feed.
  2. Choose a name, for example Talon.One coupon codes.
  3. In URL, paste the generated URI.
  4. Set Format to JSON.
  5. In Authorization token, type ApiKey-v1 and enter your the API generated earlier.

Creating a template and linking the data feed

  1. Create an Iterable template that will be used for your marketing campaign

  2. In the Advanced Options tab, select your Talon.One data feed.

    For more information about data feeds, see the Iterable docs.

  3. Reference the coupon code and/or entire response from Talon.One within the email template by using square brackets.

    For example: Your coupon code is [[Value]]!.

    See the Iterable Docs.

  4. Check the template and placement of the data feed response by using the Preview with data tool.

  5. Click Load template feed in order to bring in the data feed response data into the template.