Skip to main content

Set up a Klaviyo flow

Written by Wendy

If you prefer, you can check out this information in video format.

In this guide, we’ll show you how to set up a Klaviyo flow that sends results emails to your customers who completed your Lantern quiz.

Important note

The only event we send to Klaviyo is: Completed Lantern Quiz (v2)

This event contains everything you need to personalise your emails based on quiz responses.

Data Included in the Completed Lantern Quiz (v2) Event

The Completed Lantern Quiz (v2) event provides an array of data fields you can use in your Klaviyo emails to personalize messages based on the quiz results.

This event includes:

  • Session ID – a unique identifier for each quiz completion

  • Results page URLs – both full and short versions (results_url_full and results_url_short)

  • Product recommendations – based on quiz answers

  • Quiz questions and answers – all responses given by the user

Image showing the Completed Lantern Quiz (v2) event structure, highlighting key data fields like session ID, results page URLs, product recommendations, and quiz questions and answers sent to Klaviyo.

Why Use Completed Lantern Quiz (v2) to send automatic emails

This event is used as the trigger for your flow because:

  1. It sends instantly

    The event is triggered as soon as a user completes the quiz.

  2. It triggers every time

    If a user takes the quiz multiple times, the event will fire each time.

  3. It always sends the latest data

    Each time the quiz is completed, the event includes the most up to date answers and recommendations.

Here’s how to set up your Klaviyo flow step-by-step.

Step 1: Create a New Flow

1.1. Go to Flows in Klaviyo

1.2. Click Create Flow

1.3. Select Build your own

1.4. Name your flow

1.5. Choose Create manually

GIF showing how to navigate to the Flows section in Klaviyo, click 'Create Flow,' select 'Build your own,' name the flow, and proceed with the manual setup.

Step 2: Select a Trigger

2.1. Click Select a Trigger

2.2. Go to Your Metrics

2.3. Select API

2.4. Choose Completed Lantern Quiz (v2)- followed by the correct quiz slug

2.5. Click Save, then Confirm and Save

GIF demonstrating how to select the "Completed Lantern Quiz (v2)" API event as a flow trigger from the Your Metrics tab in Klaviyo.

Step 3: Set re-entry behaviour (important)

To make sure users receive updated results each time they complete the quiz, select Allow re-entry (this is selected by default)

This makes sure:

  • Users can enter the flow every time they complete the quiz

  • Each email reflects their latest results

Image showing the Klaviyo flow trigger settings with the Allow re-entry option selected under Re-entry criteria, so users can enter the flow again each time they complete the Lantern quiz.

Step 4: Add an email

4.1. Drag an Email block into the flow

4.2. Connect it to the trigger

4.3. Click Set Up Email

4.4 Add your sender details and subject line

GIF showing how to drag an Email action into the flow, connect it to the trigger, and begin setting up the email content in Klaviyo.

Customising your email

To personalise your emails, you use the data sent in the event.

For more guidance:

How the trigger works

The flow is triggered every time someone completes the quiz, as long as re-entry is allowed.

This means:

  • Users will receive the email each time they complete the quiz

  • Each email uses the latest quiz data

  • No additional filters are required for this setup

Advanced: Trigger filters (optional)

Trigger filters are optional and should only be used if you do not want the flow to send every time a quiz is completed.

Important limitations: Because Completed Lantern Quiz (v2) is a metric trigger, filters can only use data included in that event.

Available fields include:

  • results_url_full

  • results_url_short

  • session_id

  • winner_variants

  • $value

Image showing the Trigger filters settings in a Klaviyo flow, with the available event fields for the Completed Lantern Quiz (v2) metric trigger, including results_url_full, results_url_short, session_id, winner_variants, and $value.

You cannot use general browsing behaviour (such as page URL or site activity) as trigger filters for this event.

Related Articles
Klaviyo Integration
Set up Klaviyo Segments
IMPORTANT Update to Our Klaviyo Integration
Dynamic Content Block Variants in Klaviyo
How can I send customers emails with their quiz results?
Did this answer your question?