> For the complete documentation index, see [llms.txt](https://docs.getcohort.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getcohort.com/integrations/apps/brevo.md).

# 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>