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.

Before you begin

Make sure that you have:

  • Connected your Lantern quiz to Klaviyo.

  • Completed a test quiz submission using an email address.

  • Confirmed that the Completed Lantern Quiz (v2) event appears on the test profile in Klaviyo.

Important note

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

This event contains everything you need to personalize 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 slug of the quiz you want to use.

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

2.5 Under the re-entry criteria, keep Allow re-entry selected. This is selected by default.
​2.5. Click Save, then Confirm and Save

Keeping Allow re-entry selected means:

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

  • Each new flow entry uses the quiz data included in that completion event.

Image showing the Klaviyo trigger settings with Allow re-entry selected and the Confirm and save button highlighted for the Completed Lantern Quiz (v2) trigger.

Step 3: Add and configure an email

3.1. Drag an Email action into the flow below the trigger.
​3.2. Select the Email action.
​3.3 Add the sender information, subject line, and preview text.

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.

3.4. Under Settings, uncheck Skip recently emailed profiles if you want the results email to send after every quiz completion, even when the customer recently received another email from your Klaviyo account. Then click Save.

Image showing the Skip recently emailed profiles setting unchecked in the Klaviyo email action settings, with the Save button highlighted.

Customizing your email

Customize the email content using the data included in the Completed Lantern Quiz (v2) event.

For more guidance:

Step 4: Review and turn on the flow

Use Preview flow to confirm that a test profile enters the flow and reaches the email action.

To review the email content and confirm that the quiz data appears correctly, open the email and use its preview or test options.

When the flow is ready, click Review and turn on. Under Flow status, select Live, choose Update status now, then click Save. This sets all configured actions in the flow, including the email, to Live.

GIF showing how to preview a Klaviyo flow with a test profile and open the Review and turn on screen after confirming that the profile reaches the email action.

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
Did this answer your question?