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

Privy

Create and update Privy contacts from your survey respondents

Integrating Zigpoll with Privy lets you automatically create and update contacts in Privy when someone completes a survey. Survey answers are attached to the contact as custom fields, so you can build segments and trigger email and SMS campaigns based on real customer feedback.


Step 1: Create Your Privy API Token

  1. Log into your Privy account.

  2. Go to Settings (bottom-right) and click API.

  3. Select Create Token.

  4. Give the token Read & Write Contacts permission and no expiration date.

  5. Copy the token.

API access must be enabled on your Privy account. If your token doesn't work despite being valid, contact Privy support to enable API access.


Step 2: Enable the Privy Integration in Zigpoll

  1. Log in to your Zigpoll Dashboard.

  2. Navigate to Integrations from the left-hand menu.

  3. Find Privy and toggle it on.

  4. Paste in your API Token.

  5. Press Save.


Step 3: Configure Options

  • Tags (optional): Comma-separated tags applied to every contact created or updated in Privy (e.g. survey-respondent, vip).

  • Auto Subscribe: Opts the respondent into Privy email and SMS marketing on survey completion. Only enable this if you have valid consent — subscribing survey respondents has CAN-SPAM/TCPA/consent implications. When this is off, contacts are still created/updated, but their consent status is left unchanged.

  • Remove Prefixes: By default, custom fields 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 contact fields.


What Data Gets Sent

Once enabled, every survey submission creates or updates a Privy contact with:

  • Email and/or phone number (phone is normalized to E.164; resolved from the response or from Shopify order/customer data when available)

  • Email & SMS consent set to subscribed — only when Auto Subscribe is enabled

  • Tags — if configured

  • Custom fields — each slide response, plus survey metadata (order ID, product info, etc.) when available, and a Zigpoll: Participant field linking back to the participant's detail page in Zigpoll

Contacts are matched by email or phone number.


Example Use Cases

  • Grow your list by capturing survey respondents directly into Privy.

  • Build segments based on survey responses like attribution answers or product preferences.

  • Trigger email & SMS campaigns off survey feedback (e.g. follow up with detractors).

  • Enrich existing contacts with survey data stored as custom fields.

Last updated