> For the complete documentation index, see [llms.txt](https://docs.zigpoll.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zigpoll.com/tutorials/klaviyo-url-templates.md).

# Klaviyo URL Templates

Send your survey's public link through Klaviyo and pass customer and order data along with it

Paste your survey's public link into any Klaviyo email or SMS template and responses flow back into Zigpoll and Klaviyo. This page covers what the link looks like, when you need to add anything to it, and the URL parameters to use if you do.

### Your public link

Every survey has one public link. Find it on the survey's **General** tab (it is also shown under **Delivery** when the format is **Link**). It looks like this:

```
https://survey.zigpoll.com/SURVEY_ID
```

For example: `https://survey.zigpoll.com/31jincXePxjzkeUA5`. Accounts with a [custom survey domain](/custom-survey-domains.md) will see their own domain in place of `survey.zigpoll.com`.

{% hint style="info" %}
Older versions of this article showed links in the form `https://share.zigpoll.com/ACCOUNT_ID/POLL_ID`. Those links still work, but new surveys use the shorter `survey.zigpoll.com` link above.
{% endhint %}

### With the Klaviyo integration you usually need nothing extra

If you have enabled the [Klaviyo integration](/integrations/klaviyo.md), send the public link exactly as it appears. Klaviyo appends its own tracking parameter (`_kx`) to every link in an email it sends, and Zigpoll uses that parameter with the Klaviyo API to look up the recipient's profile. The respondent's email is attached to their response automatically, and the completed survey is posted back to that same Klaviyo profile.

Add URL parameters only when you want more than identity: a Shopify order or customer ID for [order and customer tagging](/integrations/shopify.md), a checkout URL for abandoned cart flows, or a plain tag to tell one send apart from another.

### Adding parameters to the link

There are two ways to add parameters. Both produce the same result.

**Type them directly.** Append `?key=value` pairs to the link, separated by `&`. Klaviyo template tags work anywhere in the value:

```
https://survey.zigpoll.com/SURVEY_ID?email={{email}}&name={{first_name}} {{last_name}}
```

**Use the link builder.** Under the public link on the survey's **General** tab, click **Add query variables to your public link**. Enter a key and value for each parameter and copy the generated link.

Every parameter on the link is saved as metadata on the response. See [Public Link](/public-link.md) for more on how query parameters are stored.

### Templates

#### Abandoned cart flow

Include the checkout URL and email so the response is linked to the correct abandoned cart:

| Key                    | Value                          |
| ---------------------- | ------------------------------ |
| `shopify_checkout_url` | `{{event.extra.checkout_url}}` |
| `email`                | `{{email}}`                    |

```
https://survey.zigpoll.com/SURVEY_ID?shopify_checkout_url={{event.extra.checkout_url}}&email={{email}}
```

#### Post purchase flow

Include the order ID, customer ID, name, and email:

| Key                   | Value                                                                    |
| --------------------- | ------------------------------------------------------------------------ |
| `shopify_order_id`    | `{{event.extra.id}}`                                                     |
| `shopify_customer_id` | `{{event.extra.customer.id}}`                                            |
| `name`                | `{{event.extra.customer.first_name}} {{event.extra.customer.last_name}}` |
| `email`               | `{{email}}`                                                              |

```
https://survey.zigpoll.com/SURVEY_ID?shopify_customer_id={{event.extra.customer.id}}&shopify_order_id={{event.extra.id}}&email={{email}}&name={{event.extra.customer.first_name}} {{event.extra.customer.last_name}}
```

#### General email template

For a campaign that is not tied to a Shopify event, the email address is enough:

| Key     | Value       |
| ------- | ----------- |
| `email` | `{{email}}` |

```
https://survey.zigpoll.com/SURVEY_ID?email={{email}}
```

This is also the template to use if you have not connected the Klaviyo integration and still want responses tied to an email address.

Paste the finished link into your Klaviyo template and the data will start flowing into your Zigpoll dashboard.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.zigpoll.com/tutorials/klaviyo-url-templates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.