> 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:

![](/files/eO2oXm9p8n0wZRyn1wM4)

![](/files/hhQ5HcR5rmnbbg3SBidq)

{% 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:

![](/files/9Yl8CnNy3XUuWwgxAnNu)

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

![](/files/wkCQeZtfjSpw99ePpwaZ)

Similarly, enter a key for the iOS answer:

![](/files/x8RYXmpqQuWPmSgT272K)

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:

![](/files/O1B5L8cIjLp4AOq8j3qT)

![](/files/fTZpGPBf22x92JgL8xQc)

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

![](/files/FWlI7GKuWbxNXxQ07Hcz)

![](/files/merh3veGNeLlW30qamOn)

{% 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:

![](/files/BoJn6R1toJRPgp5xvNtR)

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

![](/files/NBggnHa2g9UvupiheD6h)

{% 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:

![](/files/-LsCuMQOBiXBLwEKFvrg)

![](/files/-LsCuFJX05PbKunl5M49)

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:

![](/files/-LsCvonSu67SmXrewY_k)

![](/files/-LsCvcgiJtKvA5ybTVCV)

The ID is the text in bold.

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

![](/files/7dDAvxzJQxDETmE5vsSZ)

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

![](/files/UVpL7JZwrRLRlDQkxHHK)

{% 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:

![](/files/-LsCxy_3gHJYtOAf5fqK)

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:

![](/files/x16zgAE116zxaTfaejro)

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:

![](/files/mxMj1UnM3Oa7SH1ZyO8t)