# Braze

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

***

### Step 1: Get Your Braze REST API Key

1. Log into your Braze Dashboard.
2. Navigate to **Settings > API Keys**.
3. Create a new REST API key (or use an existing one) with the **users.track** permission enabled.
4. Note your **REST API Endpoint** (e.g., `rest.iad-01.braze.com`). This is shown on the same page.

{% hint style="info" %}
Make sure the API key has the **users.track** permission enabled. If you plan to subscribe users to a subscription group via behavior actions, also enable the **subscription.status.set** permission.
{% endhint %}

***

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

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

***

### Step 3: Configure Options

* **Send User Attributes** (on by default): Updates the Braze user profile with survey response data as custom attributes each time a survey is submitted. Turn this off if you only want to track events.
* **Remove Prefixes**: By default, custom attributes are prefixed with "Zigpoll:" (e.g., `Zigpoll: How did you hear about us?`). Enable this to remove the prefix, which is useful if you want to match survey data with existing user attributes.

***

### What Data Gets Sent

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

**Custom Event:**

* Event name: `Zigpoll Survey Completed`
* Event properties include the survey title and all slide responses

**User Attributes** (if enabled):

* Each slide response is stored as a custom attribute on the user profile
* A `Zigpoll: Participant` attribute links back to the participant's detail page in Zigpoll
* Survey metadata (order ID, product info, etc.) is included if available

Users are matched by their participant ID as the `external_id`. If an email address is available, it is also attached to the profile.

***

### Example Use Cases

* **Trigger a follow-up campaign** when a customer reports a negative experience.
* **Build segments** based on survey responses like attribution answers or product preferences.
* **Personalize messaging** using custom attributes from survey data.
* **Subscribe users** to a specific email or SMS list based on their survey answers.


---

# 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/braze.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.