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

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