Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Braze

Send survey responses and customer profiles into 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.

Make sure the API key has the users.track permission enabled. If you plan to subscribe users to a subscription group via survey actions, also enable the subscription.status.set permission.

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 question responses

User Attributes (if enabled):

  • Each question 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. If a phone number is captured from the survey response (or, when Shopify is connected, the Shopify customer phone), it is normalized to E.164 format and stored on the user's standard phone attribute. This only stores the number on the profile — it does not opt the user into SMS marketing or change any subscription group.

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.

Last updated