---
title: Brevo
slug: brevo
createdAt: 2025-04-23T09:26:06.990Z
---

*Our Brevo integration is getting an update. This document contains the documentation for the new and old Brevo integrations.*

# Brevo (New Method)

## Setting up the integration&#x20;

To set up the integration, all you need is to generate an API key in Brevo and add this to Fiona.&#x20;

### Generate Brevo API Key&#x20;

- Log in to the [Brevo dashboard](https://app.brevo.com/settings/keys/api).&#x20;
- Click on your organisation's name in the top right and go to **Settings.&#x20;**
- Choose **SMTP & AP**I and go to the **API Keys & MCP** tab.&#x20;
- Click on **Generate API key&#x20;**&#x74;o generate a dedicated API key.&#x20;

![](https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/qtrNrIfkl9OfmMjz4SY2O_image.png)

### Add the Brevo API Key to Fiona

In Fiona, go to **Settings > Integrations** > and open the Brevo integration settings. Here you can paste the API key of Brevo.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/9SKeeVg3NyLDx_QuBX8En_image.png" size="70" isUploading="false" width="765" height="215" darkWidth="765" darkHeight="215" showCaption="false"}

### Add IP Address to Brevo

If you have secured your Brevo account with a list of Authorized IP addresses, make sure to add Fiona's IPs to Brevo: go to Brevo's [security settings](https://app.brevo.com/security/authorised_ips) and add the IP addresses "37.97.141.136" and "37.97.150.233," to your list of Authorized IP addresses in Brevo. &#x20;

### Ignore Mailing lists&#x20;

Are there any lists in Brevo that you do not want to synchronise with Fiona? You can exclude these from the integration by adding their list IDs to the Brevo integration settings. You can find the IDs of your mailing list by going to **[Lists](https://app.brevo.com/contact/list-listing)** in Brevo and adding the ID's (without #) to the field **Ignored list IDs** in Fiona. Separate your lists with a comma.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/VccAhUPjvJynz506NXsTI_image.png" size="80" isUploading="false" width="1271" height="883" darkWidth="1271" darkHeight="883" showCaption="false"}

###

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/p-jLJR8S6ZPzxAba1xeXi_image.png" size="70" isUploading="false" width="765" height="215" darkWidth="765" darkHeight="215" alt="Add list IDs comma separated to Fiona" showCaption="false"}

In this example, list 4 and 6 won't synchronise with Fiona. Contacts can only be added to this lists through Brevo

### User Rights&#x20;

Brevo Mailing can be accessed through a special section on a person or company card. Before using the integration, please ensure that the correct teams have access to the mailing lists.&#x20;

Go to **Settings > Teams > Team XYZ**

- To enable the section on <u>company</u> cards: **CRM > Company > Brevo Subscriptions**
- To enable the section on <u>people</u> cards: **CRM > Person > Brevo Subscriptions**

## Using the integration&#x20;

After adding the API key, your contacts will automatically be synced between Brevo and Fiona.&#x20;

### Brevo Subscriptions&#x20;

To subscribe or unsubscribe someone to a mailing list, go to the corresponding person or company card and head to the **Brevo Subscriptions&#x20;**&#x73;ection. Here you see an overview of the lists a person or company is subscribed to.&#x20;

Toggle the "Show all Brevo lists" switch to show all available lists.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/9CPD5LCT2-vi5bWFFp3oL_image.png" size="70" isUploading="false" width="752" height="203" darkWidth="752" darkHeight="203" showCaption="false"}

Now you can check and uncheck the mailing lists you want to subscribe someone to. All changes will appear in Brevo right away. There is no need to sync or publish your changes. &#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/JTCcGIsoxKl28QwNMzxTw_image.png" size="70" isUploading="false" width="747" height="535" darkWidth="747" darkHeight="535" showCaption="false"}

Default mailing address&#x20;

Contacts are synchronised based on the default email address on the Person or Company card. In case a default email address is missing, Fiona will diplay the following message.&#x20;

![](https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/_dFMVWs-5NvHuOWMQqL0A_image.png)

### Unsubscribed users

In case one of your contacts unsubscribed from your mailing lists, you will see the following message in Fiona.&#x20;

![](https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/2ooxl09_YXTe_FdP_S9UW_upload.png)

You won't be able to subscribe this contact to any of the mailing lists in Fiona. In case you want to re-subscribe this contact to a mailing list first unblock them in Brevo.&#x20;

Brevo (documentation deprecated as of 10-09-26)

With the Brevo integration you can easily sync mailing lists from Fiona to your lists in Brevo. &#x20;

# Brevo (Old Method)&#x20;

## Setting up the integration

To successfully set up a integration with Brevo, you will need to:&#x20;

- Generate a API Key&#x20;
- Add the API Key to Fiona
- Map Mailing lists to brevo

### Generate Brevo API key

Log in to [Brevo.com](https://www.brevo.com/) to Generate a API Key. You can generate the key by clicking on “[SMTP & API](https://app.brevo.com/settings/keys/api)” in the menu under your organisation's name.&#x20;



::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/dYCmdV7Krtzd8PT5ifN7j_image.png" size="44" width="577" height="660" position="center" darkWidth="577" darkHeight="660" showCaption="false"}

Now we have to add the Brevo API key to Fiona.&#x20;

### Add the Brevo API Key to Fiona

In your Fiona, go to Settings -> Integrations -> and open the Brevo integration settings. Here you can paste the API key of Brevo.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/-t8BUUGjw-S8n4B1dHgcr_image.png" size="72" width="960" height="206" position="center" darkWidth="960" darkHeight="206" showCaption="false"}



::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/_MZ3-3XzK8O-Cbod_JEQb_image.png" size="46" width="557" height="323" position="center" darkWidth="557" darkHeight="323" showCaption="false"}

### Add IP Address to Brevo

Go to the Brevo [security settings](https://app.brevo.com/security/authorised_ips) and add the IP addresses "37.97.141.136" and "37.97.150.233," to your list of Authorized IP addresses in Brevo. &#x20;

### Mapping Mailing Lists

Now you need to match your Brevo Mailing lists to the Mailing lists you have set up in Fiona. In the Integration settings in Fiona you will find a table with all your active mailing lists. On the right side of the table, you can map these with a 'list' from Brevo. Simply match the correct List ID from Brevo to the mailing list in Fiona.&#x20;

## How to sync people and companies&#x20;

Now the integration has been set up, you can start syncing mailing lists to Fiona. You will find the Brevo Publication Channel in the Publication\:Settings section of a person and company card. Select "Publish" to sync the person or company to Brevo.&#x20;

Before you select Publish, always make sure that a person has a default email address.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/JFRuCdnqqdrOiO_HYQapX_image.png" size="50" width="547" height="152" position="center" darkWidth="547" darkHeight="152" showCaption="false"}

You can also publish **in bulk&#x20;**&#x66;rom an overview of People or Companies and Organisations.&#x20;

### Note

Companies in Fiona will appear in the last name section of a contact in Brevo.&#x20;

The integration works one way; meaning that changes you make in Brevo won't appear in Fiona.&#x20;

