---
title: Iterable incoming webhook setup guide
description: This article describes how to use the Iterable data source to create a webhook in your Iterable account and send actionable events to Tealium.
url: https://docs.tealium.com/server-side/data-sources/webhooks/setup-guides/iterable/
---## Prerequisites

* [Iterable account](https://app.iterable.com/login)
* Tealium EventStream or Tealium AudienceStream

## How it works

Iterable offers a [Webhook API](https://support.iterable.com/hc/en-us/articles/208013936-System-Webhooks) that sends outgoing requests to an endpoint that you specify. These requests inform Tealium EventStream about activity in your Iterable account. When you add the Iterable data source a unique endpoint is generated. This endpoint is used to configure the Iterable webhook.

## Iterable data source

The Iterable data source generates a unique URL to use in your Iterable webhook configuration. The URL is generated in the following format:

```
https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY
```

To add the Iterable data source to your Tealium Customer Data Hub profile, see [Data Sources](https://docs.tealium.com/about-data-sources/). After adding and connecting the data source, save and publish your profile.

## Iterable setup

Once you have your data source endpoint, use the following steps to go to your Iterable account and create the webhook.

1. Log in to your Iterable account.
1. Go to **Integrations &gt; System Webhooks**.
1. Click **Create Webhook**.  
The system webhook creation form displays.
1. Enter the endpoint generated from the Tealium data source as the Webhook URL.
1. Click **Edit**.
1. Check the **Enabled** checkbox.
1. Click **Save**.

## Events and attributes

All incoming Iterable event attributes are automatically prefixed with `iterable_`. For example, Iterable will send the `eventname` attribute to Tealium and it will be converted to `iterable_eventname` (all lowercase).

For a full list of webhook events and attributes generated by **Iterable**, see the [Iterable Webhook Documentation](https://support.iterable.com/hc/en-us/articles/208013936-System-Webhooks).

|**Event Attribute**| **Type**| **Example**|
|---| ---| ---|
|`iterable_datafields_appalreadyrunning`| Boolean| false|
|`iterable_datafields_browsertoken`| String| cZn\_inqLGPk:APA91bHsn5jo0-4V55RB38eCeLHj8ZXVJYciU7k6Kipbit3lrRlEe2Dt6bNzR4lSf6r2YNVdWY8l90hV0jmb\_Y7y5ufcJ68xNI7wbsH6Q2jbEghA\_Qo4kWbtu6A4NZN4gxc1xsEbyh7b|
|`iterable_datafields_campaignid`| Number| 723636|
|`iterable_datafields_campaignname`| String| My campaign name|
|`iterable_datafields_canonicalurlid`| String| 3145668988|
|`iterable_datafields_channelids`| Number| Example: 8539|
|`iterable_datafields_city`| String| San Francisco|
|`iterable_datafields_contentavailable`| Boolean| false|
|`iterable_datafields_contentid`| Number| 3681|
|`iterable_datafields_createdat`| String| 2019-08-07 23:43:48 +00:00|
|`iterable_datafields_device`| String| Gmail|
|`iterable_datafields_email`| String| docs@iterable.com|
|`iterable_datafields_emailids`| String| Example: 723636:t1020396:docs@iterable.com|
|`iterable_datafields_emailsubject`| String| My subject|
|`iterable_datafields_expiresat`| String| 2019-08-08 22:37:40 +00:00|
|`iterable_datafields_fromphonenumberid`| Number| 258|
|`iterable_datafields_fromsmssenderid`| Number| 258|
|`iterable_datafields_inappbody`| String| &lt;!DOCTYPE html PUBLIC \\\\-//W3C//DTD XHTML|
|`iterable_datafields_ip`| String| 162\.245.22.159|
|`iterable_datafields_isghostpush`| Boolean| false|
|`iterable_datafields_linkid`| String| 3145668988|
|`iterable_datafields_linkurl`| String| <https://www.iterable.com>|
|`iterable_datafields_messagecontext_savetoinbox`| Boolean| false|
|`iterable_datafields_messagecontext_trigger`| String| immediate|
|`iterable_datafields_messageid`| String| 4238c918b20a41dfbe9a910275b76f12|
|`iterable_datafields_messagetypeids`| Number| Example: 9106|
|`iterable_datafields_payload_path`| String| "your\_folder/30"|
|`iterable_datafields_platformendpoint`| String| &lt;Platform endpoint&gt;|
|`iterable_datafields_pushmessage`| String| Push message text|
|`iterable_datafields_reason`| String| DuplicateMarketingMessage|
|`iterable_datafields_recipientstate`| String| Complaint|
|`iterable_datafields_region`| String| CA|
|`iterable_datafields_signupsource`| String| ResubscribePage|
|`iterable_datafields_smsmessage`| String| Message text|
|`iterable_datafields_smsproviderresponse_code`| Number| 20404|
|`iterable_datafields_smsproviderresponse_message`| String| The requested resource /2010-04-01/Accounts/ACCOUNT\_NUMBER/Messages.json was not found|
|`iterable_datafields_smsproviderresponse_more_info`| String| <https://www.twilio.com/docs/errors/20404>|
|`iterable_datafields_smsproviderresponse_status`| Number| 404|
|`iterable_datafields_templateid`| Number| 1020396|
|`iterable_datafields_templatename`| String| My template name|
|`iterable_datafields_tophonenumber`| String| +16503926753|
|`iterable_datafields_transactionaldata_comment`| String| transactionalData lists the...|
| `iterable_datafields_unsubsource` | String| EmailLink|
| `iterable_datafields_url` | String|  [https://iterable.com/?\_e=a4b8cc0358422787f5cd5525005017172432ae33](https://iterable.com/?_e=a4b8cc0358422787f5cd5525005017172432ae33) |
| `iterable_datafields_useragent` | String| Mozilla/5.0 (Macintosh; Intel Mac OS X 10\_12\_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36|
| `iterable_datafields_useragentdevice` | String| Mac|
| `iterable_datafields_workflowid` | Number| 53505|
| `iterable_datafields_workflowname` | String| My workflow name|
| `iterable_email` | String| dev@tealium.com|
| `iterable_eventname` | String| pushUninstall|

## Vendor documentation

* [Iterable Webhook Documentation](https://support.iterable.com/hc/en-us/articles/208013936-System-Webhooks)
