# Brevo

#### Step #1: Create your integration

* Get your API key from Brevo. You can generate one in your Brevo dashboard under **SMTP & API → API keys**: <https://app.brevo.com/settings/keys/api>

{% hint style="info" %}
Make sure the API key has access to **Contacts** and **Lists** so Zigpoll can fetch your lists and subscribe new contacts.
{% endhint %}

* In Zigpoll: Click Settings → Manage Integrations → Enable the Brevo Integration
* Paste your API key into the input field and press save.

#### Step #2: Pick a list (optional)

Toggle **Auto Subscribe** to subscribe respondents to a Brevo contact list automatically. You can choose a single list for **All Surveys**, or map specific surveys to specific lists. Brevo lists load from your account once your API key is saved.

#### Step #3: Collect Your Data

Once your integration is enabled, Zigpoll will create or update a Brevo contact each time a respondent submits a survey (provided we have an email for them — either from a Zigpoll email field, or from your Shopify customer data if you use our Shopify integration).

The following contact attributes are sent on every submission:

* `SENTIMENT` — the respondent's average sentiment score (numeric)
* `SENTIMENT_LABEL` — `positive`, `neutral`, or `negative`
* `ZIGPOLL_PARTICIPANT_URL` — a deep link to the participant's record in Zigpoll
* One attribute per slide, named after the slide's handle (uppercased, with non-alphanumeric characters converted to underscores)

{% hint style="warning" %}
**Important:** Brevo only stores attributes that have been pre-defined in your account. Any attribute Zigpoll sends that doesn't already exist in Brevo will be silently dropped.

Before you go live, head to **Contacts → Settings → Contact attributes** in Brevo and create the attributes above (`SENTIMENT`, `SENTIMENT_LABEL`, `ZIGPOLL_PARTICIPANT_URL`) plus one entry per slide handle you want to capture. Use type **Text** for most fields, **Number** for `SENTIMENT`, and **Date** for date slides.
{% endhint %}

#### Conditional subscribes via slide logic

You can also subscribe respondents to a list based on how they answered a particular question. In any slide's editor, open the **Logic** section, add a condition, and choose **Subscribe to Brevo list** as the action. The contact will be added to the chosen list only when the condition is met — useful for routing happy customers and detractors to different lists, or for opt-in flows triggered by a specific answer.

#### Using the data

Brevo will treat the new contact like any other — you can build segments off the attributes Zigpoll syncs (e.g. everyone with `SENTIMENT_LABEL = negative`), trigger automations from list membership, or include the survey data as merge tags in your campaign emails.


---

# 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://docs.zigpoll.com/integrations/brevo.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.