> 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.