# Klaviyo guide

When a user completes a pickzen, all captured information can be sent to a Klaviyo list. This includes the lead information, selected answers, and information filled in from form-slides.

Let’s suppose we have a Survey which these two slides:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2F2ZNcn1jfVEItVlzdQbsL%2Fimage.png?alt=media\&token=d26ab851-ab18-4e51-b0d6-bdb5c14e0a31)

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FxJtgAqsHcZDiUXjB7LQ0%2Fimage.png?alt=media\&token=05d0f47a-f3ae-420f-bc8c-3d5c82e43aa1)

{% hint style="warning" %}
Klaviyo needs that leads sent to a list have an email. If your pickzen does not provide an email field, no information will be sent to Klaviyo.
{% endhint %}

To send your leads and user preferences to Klaviyo, follow these steps:

Click on the Android answer settings:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FbIuP8aV6WZwSjAz1tmk2%2Fimage.png?alt=media\&token=d191c919-331a-43fd-a543-50d8faf757d4)

Go to the Advanced tab and enter a key in the Answer key field:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FoJ6ZqvSwC3q4RVe6GMFO%2Fimage.png?alt=media\&token=c41a79c2-b0f0-4c2b-83a7-ad19ab54d754)

Similarly, enter a key for the iOS answer:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FR77besW2Fp6N3DSONMFc%2Fimage.png?alt=media\&token=7b19bce0-a2dc-4031-ad72-43713cb0deb0)

In this case, the information sent to Klaviyo will be *Android=\** or *iOS=\** depending on the answer selected by the user. However, in the case of single selection answers, it would be preferred to send something like *OS=Android* or *OS=iOS.* Use the following keys to achieve this:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FVOEybgEKhnW7MoPmCBPR%2Fimage.png?alt=media\&token=ed3942be-c2aa-4934-b307-b8200fcfb307)

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2F2WHKIPKW9jgzNYNXFMSD%2Fimage.png?alt=media\&token=a40f4d22-5248-4a53-aa7c-f79b3a6264ce)

Now, select the form slide and enter the field keys for the fields *name* and *city* (the email field will be sent automatically to Klaviyo):

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FVf4qTEktmlij5pV6DluI%2Fimage.png?alt=media\&token=44a47534-9bca-4df2-8dd2-e453c5dadf4b)

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FYQjLXfKhrkvpEx1BpOZh%2Fimage.png?alt=media\&token=df3dad0f-2ffa-468d-a26a-d1606c6f794a)

{% hint style="info" %}
In Klaviyo, there are some predefined field names as $first\_name that have to be set as Field key to be mapped correctly in Klaviyo lists.
{% endhint %}

Once all answers and fields are configured, publish the pickzen, exit the editor, and go to the Klaviyo integration:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FncqAd2yy7bxQRTPlQmof%2Fimage.png?alt=media\&token=3f6b1b8c-abe9-4df0-8482-2bc0306f7f44)

Click on *Add integration* to create a new one. Then, select the pickzen you want to integrate and configure the rest of the parameters:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2F04F2H616o2hqkU2NcqRT%2Fimage.png?alt=media\&token=a84888ac-ebb4-4350-b957-dd6185698a82)

{% hint style="warning" %}
If Require confirmation is checked, the lead will only appear in Klaviyo once the user has accepted to be included in the list through a confirmation email.
{% endhint %}

 Find or your Klaviyo private API Key in the Settings panel within your account:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTaL6FQB3RzlkCwQfN%2F-LsCnCJFpQ5jJswnhHyE%2F-LsCuMQOBiXBLwEKFvrg%2Fimage.png?alt=media\&token=f2d459a4-3779-4350-9a59-fab74eef1dfc)

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTaL6FQB3RzlkCwQfN%2F-LsCnCJFpQ5jJswnhHyE%2F-LsCuFJX05PbKunl5M49%2Fimage.png?alt=media\&token=7a108611-2bd5-40b4-8ccc-d653918e2592)

The page that shows up has your API keys. If you don’t have any keys, you can create the first one by clicking on the *Create API Key* button.

{% hint style="warning" %}
Select a **private API key**. Otherwise, the integration won't work.
{% endhint %}

Get the List ID where you want the information to be sent, select the list, and click on Settings:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTaL6FQB3RzlkCwQfN%2F-LsCnCJFpQ5jJswnhHyE%2F-LsCvonSu67SmXrewY_k%2Fimage.png?alt=media\&token=13986ed9-a77a-4629-92ce-763db31178d3)

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTaL6FQB3RzlkCwQfN%2F-LsCnCJFpQ5jJswnhHyE%2F-LsCvcgiJtKvA5ybTVCV%2Fimage.png?alt=media\&token=0ab8cf19-969b-445a-b7ef-9a00937f4df0)

The ID is the text in bold.

Enter the private API Key and List ID in the corresponding fields:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FjJqnxp0BxnOg3yGM8W0E%2Fimage.png?alt=media\&token=c444466c-0d31-4159-b790-5b29c12ccd42)

Now, put your answer and field keys that you defined previously in the Keys field separated by semicolons:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2Fz9757SLquCoHbJB2w50d%2Fimage.png?alt=media\&token=69defdb0-1f06-47dd-ba13-003ca84eaee6)

{% hint style="warning" %}
It is very important that they are separated by semicolons, otherwise, no information will be sent to Klaviyo.
{% endhint %}

Finally, test your survey and check your leads shows up in Klaviyo:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTaL6FQB3RzlkCwQfN%2F-LsCnCJFpQ5jJswnhHyE%2F-LsCxy_3gHJYtOAf5fqK%2Fimage.png?alt=media\&token=d736d8de-2b11-4f1b-8c6f-056faa8dd498)

You can find the answers in the Custom Properties section at the bottom right.

{% hint style="warning" %}
Once a lead is subscribed to a list, no new user can be added with the same email. If a user retakes the Assistant and answers differently, the lead information and custom properties will be updated in Klaviyo.
{% endhint %}

### Testing

In order to test your integration to Klaviyo, the button *Test* can be used:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2Fhc1POW5oLSNTYrrQYiz1%2Fimage.png?alt=media\&token=142dbdd6-e341-4006-adac-f456c5d897a9)

Once configured, click on the Test button and a new lead with a random email based on your current username will be sent to the Klaviyo list along with your keys filled up with sample data:

![](https://1947171238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrTaL6FQB3RzlkCwQfN%2Fuploads%2FzgQ5SEzj7YyvRmuO7jJk%2Fimage.png?alt=media\&token=efeb5e94-4ce2-4576-aa3c-ce49a95f6744)


---

# 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://help.pickzen.com/guides/klaviyo-guide.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.