# Iterable

Integrating Zigpoll with Iterable lets you automatically push survey responses into your Iterable workspace as user data fields and custom events. Use this data to build segments, trigger journeys, and personalize messaging based on real customer feedback.

***

### Step 1: Get Your Iterable API Key

1. Log into your Iterable Dashboard.
2. Navigate to **Integrations > API Keys**.
3. Create a new Server-Side API key (or use an existing one).

{% hint style="info" %}
Make sure the API key has **Server-Side** type so it can create/update users and track events.
{% endhint %}

***

### Step 2: Enable the Iterable Integration in Zigpoll

1. Log in to your Zigpoll Dashboard.
2. Navigate to **Integrations** from the left-hand menu.
3. Find **Iterable** and toggle it on.
4. Enter your **API Key**.
5. Press **Save**.

***

### Step 3: Configure Options

* **Send User Update** (on by default): Creates or updates the user in Iterable with survey response data fields each time a survey is submitted. Turn this off if you only want to track events.

***

### What Data Gets Sent

Once enabled, every survey submission sends the following to Iterable:

**User Update** (if enabled):

* Creates or updates a user via `POST /api/users/update`
* Data fields include all survey responses and a link to the participant's Zigpoll profile

**Custom Event:**

* Event name: `surveyCompleted`
* Data fields include the survey title and all slide responses

Users are matched by email address. If no email is available, the participant ID is used as a fallback userId.

***

### Example Use Cases

* **Trigger a journey** when a customer gives negative feedback.
* **Build segments** based on survey responses like attribution or satisfaction scores.
* **Personalize messaging** using data fields from survey data.
* **Enrich user profiles** with qualitative feedback for smarter campaigns.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigpoll.com/integrations/iterable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
