Iterable

Table of Contents

Iterable is an integrated, cross-channel platform—built for marketers, trusted by engineers, designed with intelligence.

Setup

Navigate to Integrations > API Keys and create a new API key with standard permissions.

Use the API key generated to create a new Iterable destination in the Destinations tab of Hightouch.

Now that you have a new Iterable destination, you can start piping data!

Objects

Users are currently the only objects that can be synced to Iterable.

Modes

Upsert

In this mode, new users will be inserted into Iterable and all designated users will be kept up-to-date within Iterable. Upsert is currently the only mode available for use with the Iterable destination.This mode is good for the following scenarios:

You want to push objects into Iterable and want to keep the data up-to-date

Upsert has three configuration parameters:

Name	Details
Hightouch Column Containing Iterable Email	The name of the column on the Hightouch query that will map to the email field for users in Iterable. This is used as the primary key in Iterable.
Hightouch Column Containing Iterable User ID	The name of the column (id, created_at, first_name, etc..) that will map to the userId field for users in Iterable.
Hightouch to Iterable Field Mappings	A list of fields that will be pushed to new users in Iterable. Each time a sync occurs in Hightouch these users will be updated.

Here is an example:

Only the email column is required, all other mappings are completely optional.

Events

Custom events are currently the only events that can be synced to Iterable.

Modes

Upsert

In this mode, new events will be inserted into Iterable, and those events will be kept up-to-date within Iterable using the event ID. Upsert is currently the only mode available for use with Iterable events.These fields are required for events: