Skip to main content

Brevo Integration

Written by Traian

Connecting Lantern with Brevo lets you send quiz response data straight into your Brevo account. Quiz takers become Brevo contacts, their answers are stored as contact attributes, and every completed quiz fires an event you can use in automations, segments and personalized campaigns.

This guide walks you through connecting the two platforms and mapping quiz data.

1. Generate an API key in Brevo

1.1. Log in to your Brevo account.

1.2. Open Settings (the gear icon at the top right), then go to SMTP & API and open the API keys & MCP tab.

1.3. Click Generate API key.

Image showing the API keys & MCP tab in Brevo with the Generate API key button highlighted.

1.4. Give the key a clear name (e.g., Lantern) and click Generate.

1.5. Copy the key. It starts with xkeysib- and Brevo only shows it once.

Image showing how to name and generate a Brevo API key, then copy the generated key.

Important: Brevo asks you to verify your account by phone before it issues the first API key. If you see a "One last step to secure your account" dialog, complete the verification and try again.

2. Find your list ID (optional)

If you want quiz takers added to a specific Brevo list, open Contacts, then Lists, and note the number in the ID column next to the list you want to use. If you skip this step, contacts are still created in Brevo, just not in any list.

Image showing the Lists page in Brevo with the list IDs highlighted.

3. Connect Brevo in Lantern

3.1. In your Lantern dashboard, go to Integrations.

3.2. Find the Brevo card and click Connect.

3.3. Paste your Brevo API key into the API Key field. If you want contacts added to a list, enter the list ID in the List ID field.

3.4. Click Connect. If the key (and the list ID, when provided) is valid, Lantern shows the integration as connected. You can update the key or the list, or disconnect, at any time.

Image showing the Brevo integration settings in Lantern with the API Key and optional List ID fields.

Once connected, all active quizzes in your account automatically send eligible contact and quiz data to Brevo. There's no need to set up individual quiz connections.

Image showing the Brevo integration connected successfully in Lantern.

Answers from questions set to Don't share or Don't store are not sent to Brevo. Learn more about Sensitive Data Controls.

4. Mapping question responses to attributes

Brevo stores quiz answers as contact attributes. However, Brevo doesn't automatically use or create the Property IDs already set up for your quiz questions. Even if a question has a Property ID, you still need to create a matching contact attribute in Brevo and enter its name in the question's Brevo ID field in Lantern. A Property ID is not needed: any question with a Brevo ID is sent, including single and multiple choice questions. When several answers are selected, they are sent comma-separated.

Follow these two steps to set this up:

4.1. In Brevo, go to Settings. Under CRM, select Contacts, then open Contact attributes. Under Normal Attributes, click Create attribute. Choose Text as the attribute type and enter an uppercase name such as SKINTYPE.

Image showing how to create a Text contact attribute named SKINTYPE in Brevo.

4.2. In the Lantern quiz editor, select the question and open Integrations (Integration Settings on text, slider and date questions) in the right-hand panel, then enter the attribute name in the Brevo ID field (e.g., SKINTYPE). The field shows once Brevo is connected.

Image showing the Brevo ID field in the Lantern quiz editor with SKINTYPE entered for a question.

The quiz taker's first name, last name and phone number, when collected on the opt-in page, are sent automatically to the built-in FIRSTNAME, LASTNAME and SMS attributes.

5. How data flows to Brevo

When a quiz taker completes your quiz a contact is created (or updated, if the email already exists) in Brevo with:

  • Email address

  • Phone number (if collected), as the SMS attribute

  • First name (if collected), as the FIRSTNAME attribute

  • Last name (if collected), as the LASTNAME attribute

  • The mapped attributes from quiz answers shared with Brevo

  • Membership of the list you chose, if you entered a list ID and the quiz taker agreed to marketing

  • Marketing consent: if a new quiz taker declines marketing on the opt-in page, the contact is created as not subscribed. If the email already exists in Brevo, Lantern doesn't change its marketing status when they decline.

Important: Email and SMS marketing are enabled by default for every quiz. You can switch either off on the right-hand side of your opt-in page, under the Integration Settings drop-down.

Image showing the first name, email, and phone number fields on a Lantern opt-in page, with the Brevo email and SMS marketing options under Integration Settings.

An event called Completed_Lantern_Quiz is sent to Brevo, containing:

  • The quiz taker's answers shared with Brevo, with the question text

  • Recommended products (name, image URL, price, product URL, rank and score)

  • Quiz session details, including a link back to the results page

You can view the attributes in the contact's profile in Brevo, and the events in the contact's Recent history.

You can also let customers leave their email after they see their results, using the optional email sign-up on the Results Page. When a customer signs up there, the contact is created or updated in Brevo with their quiz answers, and the Completed_Lantern_Quiz event is sent at that moment. Any automation triggered by the event starts when the customer signs up, not when they finish the quiz.

The Results Page sign-up never asks for a phone number. It can show First name, Last name and the GDPR Checkbox (the marketing consent checkbox), which you set up under Email Sign-up on the Results Page. If the form has no consent checkbox, or the customer ticks it, the contact is created as subscribed (and added to your list, if you entered one). If the customer leaves the box unticked, it's handled like a decline on the opt-in page. To send phone numbers to Brevo, use the opt-in page. Find out how to set up both options in Collect customer emails.

Image showing a Brevo contact with first name, email, phone number, the mapped SKINTYPE attribute, and the Completed_Lantern_Quiz event in Recent history.

6. Using quiz data in Brevo automations

Once quiz data is flowing into Brevo, you can:

  • Segment contacts by quiz answers, using the mapped attributes

  • Trigger an automation when the Completed_Lantern_Quiz event is received

  • Personalize emails with the quiz answers and the recommended products from the event

Note: Brevo's event tracking is part of its Marketing Automation feature. It's included on Brevo's free plan with a contact limit; check your Brevo plan if events don't appear.

By following these steps, your Lantern quiz responses will feed directly into Brevo, ready for targeted marketing, personalization and automated campaigns.

Did this answer your question?