# Privy

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.

{% hint style="info" %}
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.
{% endhint %}

***

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


---

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