Connecting Lantern with Omnisend allows you to send quiz response data directly into your Omnisend account. This means you can store quiz answers as contact properties, keep a record of quiz completion events, and make this data available for use in future marketing activities such as segmentation, automation, and personalised campaigns.
This guide will walk you through connecting the two platforms and mapping quiz data.
1. Generate an API Key in Omnisend
1.1. Log in to your Omnisend account.
1.2. Go to Store Settings (or My Account → Store Settings, depending on your navigation menu).
1.3. Find the API section and select +Create API Key.
1.4. Give the key a clear name (e.g., Lantern).
1.5. Click Create, then copy the generated API key.
Important:
To make sure the integration works correctly, we strongly recommend creating an API key with full access.
2. Connect Omnisend in Lantern
2.1. In your Lantern dashboard, go to Integrations.
2.2. Find the Omnisend card and click Connect.
2.3. Paste your Omnisend API key into the field and click Connect.
2.4. If the key is valid, Lantern will show the integration as connected. You can disconnect or update the API key at any time.
With Omnisend, once the API key is connected, all active quizzes in your account will automatically send eligible contact and quiz data to Omnisend. There’s no need to set up individual quiz connections.
Answers from questions set to Don't share or Don't store are not sent to Omnisend. Learn more about Sensitive Data Controls.
3. Mapping Question Responses to Properties
Lantern allows you to map each quiz question to a Property ID so the answer can be stored as a custom property in Omnisend. Example:
Question: Does your pet have any specific health conditions?
Default Property ID: health_condition
This is the identifier Omnisend uses to store the answer as a custom property when the question is shared with Omnisend.
4. How Data Flows to Omnisend
When a user completes your quiz:
1. A new contact is created (or updated) in Omnisend with:
Email address
Phone number ( if this is collected)
Name (if this is collected)
Any mapped custom properties from quiz answers shared with Omnisend
Appropriate marketing consent
Important: To make sure your quiz takers are correctly subscribed to email and SMS marketing, these options are automatically enabled with each quiz. If you need to disable any of these options you can do this from inside your lantern quiz. You can find this on the right-hand side of your opt-in page, under the Integration Settings drop-down.
2. An event called Completed Lantern Quiz is sent to Omnisend, containing:
The user’s answers shared with Omnisend and their associated question text
Recommended products (including name, image URL, price, product URL, and score)
Quiz session details
You can view:
Custom properties in the contact’s profile in Omnisend
Events in the contact’s activity timeline
5. Using Quiz Data in Omnisend Automations
Once quiz data is flowing into Omnisend, it can be used to:
Personalise messages with quiz response data
We cover these topics in detail in separate guides.
By following these steps, your Lantern quiz responses will feed directly into Omnisend, letting you use the data for targeted marketing, personalization, and automated campaigns.