# Iterable

Iterable (opens new window) is the growth marketing platform that enables brands to create, execute, and optimize campaigns to power world-class customer engagement across email, push, SMS, in-app and more with unparalleled data flexibility.

# How to connect to Iterable on Workato

The connector uses API key authentication to connect Workato to Iterable.

Configuring Iterable connection

Field Description
Connection name Give this connection a recognizable name. On Workato, you can create multiple connections to the same App which can be dedicated to different teammates.
API key Generate an API key for this account here

# Generating an API key

  1. After logging into Iterable, head over to the “Integrations” tab in the top navigation bar and select the API key option in the dropdown.

Navigating to API key settings

  1. You’ll be brought to the view where you can generate a new API key for your Workato connector.

Navigating to API key settings

  1. Generate a Standard API key and give it a meaningful name. Here, we gave it the name, 'Workato-demo'. After this is done, simply provide the same key to the connector and you should be able to make a successful connection.

# Generating System webhooks

  1. Head over to the Iterable connector in Workato. Under the top navigation bar, select “tools” and select “connector SDK” from the dropdown.

Navigating to Workato connector for webhook URI

  1. Find the Iterable connector in the list of custom connectors you have installed in your Workato workspace.

Navigating to Workato connector for webhook URI

  1. On the “Source code” tab, scroll to the bottom of the page to find the debugger console. There, you’ll find the static webhook URI specific to your connector. Copy the static webhook URI link.

Navigating to Workato connector for webhook URI

  1. Workato supports system webhooks as well as custom and basic webhooks in Iterable. Head over to Iterable to configure your system and workflow webhooks.
  1. When prompted for endpoints, provide the static webhook URI link copied from your Iterable connector. No authentication is needed. Next time these events are triggered in Iterable, your Iterable triggers can pick up these webhook events.

# Triggers & Actions

The Iterable connector supports the following triggers and actions.

Triggers Actions
New Object Add subscribers to list
New workflow Bulk upsert users
Create list
Get user by email
List channels
List project lists
Send sms
Track event
Update user subscription
Upsert user

# Triggers

After configuring the webhook URIs, you’ll now be able to configure your webhook triggers for both system webhooks and workflow webhooks.

# New Object

Trigger config

When configuring a new object trigger, first select the event you want to listen on. The system webhook registered should have the corresponding event enabled on the Iterable UI.

# New Workflow

Trigger config

When configuring a new workflow trigger, provide us with the workflow ID which calls the webhook you have just made. This can be found in the URL of the workflow editor. I.e. if the url is https://app.iterable.com/workflows/1234/edit (opens new window) then the workflow ID is 1234.

# Configuring expected webhook payloads

All triggers have a schema designer for you to define the expected webhook payload. Defining these fields allow you to use attributes in the payload in downstream actions. There are 2 ways to define the output field.

Trigger config

  • Option 1

Start the recipe without configuring the output schema and send a test event to the trigger. You can then use the payload in the job history to observe the structure of the expected payload.

Trigger config

Copy this payload and paste that into the schema builder using the json wizard and all fields will be populated automatically.

  • Option 2

Manually define the fields. The names in the fields must match the keys in the json payload exactly.

# Actions

Actions in Workato allow you to create, update, and retrieve information about objects in Iterable. Use these actions to add or update user attributes, add people to lists or even send smses. Most inputs in the Iterable connector are self-explanatory and request inputs for standard fields in Iterable.

# Working with the data fields input

Some actions in the Iterable connector will have an input field called “Data fields”. This is where users can configure and create or update objects in Iterable whilst also interacting with their custom fields.

Action config

Users in Iterable are able to have custom attributes that can be created/updated during the creation or updating of the user. For example, we have this user below with fields “new_field” and “test_field”.

Action config

We can use the input field called “Data fields” to change the values in existing field or even add new field by first defining the names of the fields we want to update and then populating the input fields that appear below. The names defined must match exactly when defining the request body parameters.

Action config

This results in the following object:

Action config