> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Brevo

> Streamline your marketing efforts by syncing data into Brevo

## Supported syncing

| Type | Description | Supported Sync Modes | API Reference |
| - | - | - | - |
| **Contacts** | Sync data from any source to Brevo contacts | Upsert, Update, Insert | [Contacts docs](https://developers.brevo.com/reference/createcontact) |
| **Contact Lists** | Sync data from any source to a Brevo contact list | Upsert | [Contact lists docs](https://developers.brevo.com/reference/createlist-1) |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Brevo

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Brevo** and click **Continue**. You can then authenticate Hightouch to **Brevo**.

Enter the following required fields into Hightouch:

* **API key**:Enter a valid API key.

## Sync configuration

Once you've set up your Brevo destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Brevo destination you want to sync to.

### Syncing contacts

Sync data from any source to Brevo contacts.

### Syncing contact lists

#### List selection

Select which list in your Brevo account you'd like to upsert contacts to. If you would like to create a new list, enter the name of the list, and choose the folder to create the list in.

### Record matching

For **upsert** mode, you can match contacts by email.
For **update** mode, you can match by email, sms, or the contact's ID. Ensure the data types of the model column and Brevo field you select match.
Refer to the [record matching docs](https://docs.hightouch.com/syncs/record-matching.md) for more information.

> [!TIP]
>
> Brevo requires each email, SMS, and contact ID in your list to be unique. Brevo rejects updates that contain information that conflicts with existing contacts.

> [!NOTE]
>
> In **Insert** mode, Brevo automatically generates an identifier for every new record synced, so there is no need to match an existing record.

### Field mapping

Hightouch lets you sync contact fields via [field mapping](https://docs.hightouch.com/syncs/mapping-data.md).
You can map data from any of your model columns to the default contact fields.
Ensure your model columns data types match the data types of the fields you want to sync to.

### Delete behavior

The [delete behavior](https://docs.hightouch.com/syncs/overview.md#delete-behavior) you select dictates what to do when a row no longer appears in your model's query results. You have the following options:

| Behavior | Description |
| - | - |
| **Do nothing** | Keep the contact in Brevo with all its synced fields |
| **Clear** | Clear all the mapped fields, but keep the contact in Brevo |
| **Delete** | Delete the synced contacts from Brevo |

For Brevo Contact Lists, when records leave your query result, they are removed from your audience by default. If you would not like to delete any records from your audience, you can choose to do nothing when records leave your query result.

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).