# Brevo

**Connection type:** API key

**Available features**

* Import attributes from Brevo contacts as Cohort user properties
* Export users and their attributes to Brevo
* Export user events from Cohort to trigger Brevo automations
* Use Brevo contact lists as audience for a challenge

## Installation

**Create an API key**

* On your Brevo dashboard menu (top-right), click on SMTP & API
* Click on Generate a new API key
* Give it a name. We recommend having "cohort" in the name so it can be easily identified
* Copy the API key
* If you have [IP filtering](https://developers.brevo.com/docs/ip-security) enabled on your Brevo account, you will need to whitelist the address `34.78.122.62`

<div><figure><img src="/files/N1ckXwniIbVdy2wgh9bg" alt=""><figcaption></figcaption></figure> <figure><img src="/files/dR8Inzlgx1ma3NYRgKre" alt=""><figcaption></figcaption></figure> <figure><img src="/files/4jVXM3s7Vuau4W6yTN4N" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ukBGbFve74orRKUHvn2D" alt=""><figcaption></figcaption></figure></div>

**Install the API key on Cohort**

* On your Cohort dashboard menu (top-right), click on Apps and select the Brevo app
* Click on "Add connection"
* Paste the API key previously generated and click on create
* You will then be redirected to the "Sync users" tab to configure the different synchronisation options presented in this document

<figure><img src="/files/w2lMyTaGseVvMkT4W8Ix" alt=""><figcaption></figcaption></figure>

## Import Brevo contact attributes to Cohort

The Brevo application allows you to import Brevo contact attributes as Cohort user properties

* Activate the `Enable user import` toggle
* Select which contact attributes from Brevo you would like to import into Cohort. A user property will be created and synchronized automatically for each field you select.

{% hint style="info" %}
This step is mandatory if you also want to export Cohort user attributes as Brevo contact attributes
{% endhint %}

<figure><img src="/files/CVMbKQnRXG9hZm3Qmt2x" alt=""><figcaption></figcaption></figure>

## Export users from Cohort to Brevo

{% hint style="info" %}
User import must be activated in order to configure user export
{% endhint %}

The Brevo application allows you to export Users and/or fields from Cohort into Brevo.

* Activate the `Enable user export` toggle
* Select which users you would like to export
  * `All Users`: All of your Cohort users will be exported to Brevo as contacts
  * `Users that already exist in Brevo`: New users will not be created in Brevo, this will just add new User Properties on users that already exist in Brevo
* Select which user properties from Cohort you would like to export into Brevo and map them to the proper attributes. This imply that you first need to create the contact attributes from your Brevo dashboard if they don't exist yet

<figure><img src="/files/0G071wNUsLGNc0VwZDFS" alt=""><figcaption></figcaption></figure>

## Export users events

**Setup export**

* Activate the `Enable user events export` toggle
* You can opt to export all user events or pick only the ones you're interested in (recommended).

<figure><img src="/files/FsZZULhdSdIpZnVtJ7cW" alt=""><figcaption></figcaption></figure>

**Leveraging Cohort user events in Brevo**

Once the synchronisation enabled, the events will be forwarded in real time to Brevo so that you can use them in your automation rules, when segmenting your contacts and also in your loyalty program rules.

Here is an example on how to use the events in Brevo loyalty

{% hint style="info" %}
If you don’t see the Cohort events folder, the `cohort` application may not be activated for your Brevo account. Please contact your CSM or reach out to support.
{% endhint %}

<div><figure><img src="/files/mBEOxb9lHYmmxPX42CyQ" alt=""><figcaption></figcaption></figure> <figure><img src="/files/YljWUBaePY175ng5xVkN" alt=""><figcaption></figcaption></figure></div>

## Use Brevo contact lists as the audience for a challenge

Once you configured the API Key, you will see a new audience option when configuring a challenge

This will list your most recently updated contact lists from Brevo

When you use this option, the user will be prompted for his email when joining the challenge and we will check in real time if the user is indeed part of the list

<figure><img src="/files/yIGK7QBp23CWxOeNyQwe" alt=""><figcaption></figcaption></figure>


---

# 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.getcohort.com/integrations/apps/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.