# Klaviyo

Integrating [Klaviyo](https://apps.shopify.com/klaviyo-email-marketing) with the Quiz Kit app allows you to automatically add new customers who took your quizzes to your [Klaviyo lists](https://help.klaviyo.com/hc/en-us/articles/115005078967#h_01HB678Y7ZYS5JDNGSYJEEPPK9). 

Quiz responses are saved as custom properties for each customer, enabling targeting marketing campaigns.

{% hint style="info" %}
**Note:** 

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Basic** plan or higher.
{% endhint %}

## In this section:

* [Connecting Klaviyo to Quiz Kit](#connecting-klaviyo-to-quiz-kit)
* [Adding email capture to your quiz](#adding-email-capture-to-your-quiz)
* [Passing quiz submissions to your Klaviyo list](#passing-quiz-submissions-to-your-klaviyo-list)
* [Adding form questions](#adding-form-questions)
* [Enabling email capture on older active quizzes](#enabling-email-capture-on-older-active-quizzes)
* [Sending quiz results to customers](#sending-quiz-results-to-customers)

***

## Connecting Klaviyo to Quiz Kit

Once you've created a Klaviyo account, you can connect it to Quiz Kit. 

**Steps:**

1. From the Quiz Kit app menu, click **Integrations**.
2. Ensure the **Email marketing** tab is selected.
3. Under the Klavyio app, click **Connect**.
4. Click **Enable OAuth authentication**, then click **Continue.**
5. Review the information, then click **Allow**.

A confirmation message displays to confirm that you've connected Quiz Kit to Klaviyo.

***

## Adding email capture to your quiz

If you want to capture a customer's email from a quiz and pass it to Klaviyo, then you need to add a page in your quiz to allow them to input their email address.

**Steps:**

1. From the Quiz Kit app dashboard, click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. From the default Quiz menu, click **Add page**, then click **Email capture** from the list. The default email capture template displays. 
3. **Optional:** You can customize the template using the **Content** and **Fields** sections according to your preference. 
4. Click **Save**.

{% hint style="info" %}
**Note:** 

For GDPR reasons you can make this question optional to your customer by checking **Enable ability to skip this question**. You can also check **Enable fake emails validation** to minimize the possibility of fake email submission.
{% endhint %}

***

## Passing quiz submissions to your Klaviyo list

When you've integrated Klaviyo with your store, you can set up new quiz submissions to be sent to your Klaviyo list.

{% hint style="info" %}
**Note**

After setting up the Klaviyo connection, you need to take the quiz once yourself, up to the email submission question, so that future quiz submissions are sent to Klaviyo.
{% endhint %}

**Steps:**

1. From the Quiz Kit app, click **My Quizzes**, then click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. Click the gear wheel to open the **Settings** menu, then click **Integrations**.
3. In the **Custom properties** section, you can check any properties that you want to collect from quiz submissions to include them.
4. In the **Klaviyo** section, from the **Available lists** drop-down menu, select one of the list options.
5. Click **Save**.
6. Once you've set up your list, you need to complete your quiz once, up to the point of submitting a valid email address, in order to trigger the Klaviyo flow.

***

## Adding form questions

You can use form fields to gather additional information from your customers, like phone numbers and dates (ex. birthdays).

**Steps:**

1. From the Quiz Kit app, click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. From the default Quiz menu, click **Add page**, then click **Form field** from the list.
3. Click **Fields** > **Field 1**, then click under **Type** to select one of the following for your form response section: 
   1. **Text**: a short text field
   2. **Text Area**: a longer text field
   3. **Date**: a date picker
   4. **Number**: a number field for phone numbers and other number-related responses
4. **Optional**: Customize any other sections that you want like the field name or placeholder text.
5. Click **Save**.

{% hint style="info" %}
**Note**: 

To pass the customer's first name to Klaviyo, add one more field and insert type `first_name` in the **Marketing property name** field.
{% endhint %}

***

## Enabling email capture on older active quizzes

If you have older quizzes that have been active for a longer period of time, you might need to enable email capture by an alternative method.

**Steps:**

1. From the Quiz Kit app, click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. Click the gear wheel to open the **Settings** menu, then click **Email/SMS.**
3. Check **Show email/phone capture form before results.**
4. Click **Save.**

When you’ve completed the steps, all emails entered during quiz completion are sent to the chosen Klaviyo list, and all questions and answers are set as customer custom properties to your selected list.

You can create segments based on customer answers.

***

## Sending quiz results to customers 

You can set up an email trigger within Klaviyo so that customers are automatically sent their email results when they complete your quiz. Learn more about [sending quiz results to customers via Klaviyo](/building-a-quiz/collecting-customer-data/sending-quiz-results-to-customers-via-klaviyo.md).


---

# 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://support.quizkitapp.com/building-a-quiz/integrations/email-and-sms/klaviyo.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.