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

# Brevo

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (API Key) | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | End-user authorization guide | 🚫 |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `add-contacts-to-list` | Bulk-add one or more existing contacts, identified by email, to a Brevo contact list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-company` | Create a new company (CRM object). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-contact-attribute` | Define a new custom contact attribute (field) on the account contact schema. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-contact-folder` | Create a new contact folder to organize contact lists | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-contact-list` | Create a new contact list inside a folder. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-contact` | Create a new contact | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-deal` | Create a new deal. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-email-campaign` | Create a draft email (classic) campaign | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-email-template` | Create a new transactional email template | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-sms-campaign` | Create a draft SMS campaign. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-company` | Delete a company. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-contact-attribute` | Permanently delete a custom contact attribute from the account schema by category and name. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-contact-folder` | Delete a contact folder and all contact lists it contains. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-contact-list` | Delete a contact list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-contact` | Delete a contact | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-deal` | Delete a deal | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-email-campaign` | Delete an email campaign. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-email-template` | Permanently delete an inactive transactional email template by its numeric ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-sms-campaign` | Delete an SMS campaign. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-company` | Retrieve a single company by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-contact-folder` | Retrieve a single contact folder's details by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-contact-full-profile` | Get a 360-degree view of a contact: the contact record, its linked CRM companies and its linked CRM deals in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-contact-list` | Retrieve the details of a single Brevo contact list by its ID | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-contact` | Retrieve a single contact by email or numeric ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-deal` | Retrieve a single deal by ID | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-email-campaign` | Retrieve a single email campaign's full detail, including delivery statistics | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-email-template` | Retrieve a single transactional email template's detail. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-sms-campaign` | Retrieve a single SMS campaign by ID, including its content, recipients, status, and delivery statistics. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-transactional-email-events` | Retrieve the transactional email event log (requests, delivered, opens, clicks, bounces, etc.) for the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `link-unlink-company-contacts` | Link or unlink contacts and/or deals to a company in a single request. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `link-unlink-deal-relations` | Link or unlink contacts and/or companies to a deal. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-companies` | List companies (Brevo CRM company objects) with pagination, sorting, and optional filters. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-company-attributes` | List the schema of attributes available on company (CRM) objects. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-contact-attributes` | List the account's contact attribute schema (built-in and custom fields such as FIRSTNAME/LASTNAME). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-contact-folders` | List the account's contact folders (the organizational containers for lists) | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-contact-lists` | List the contact lists in the Brevo account | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-contacts-in-list` | List the contacts that belong to a specific contact list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-contacts` | List contacts in the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-deal-pipelines` | List the account's CRM deal pipelines and their stages. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-deals` | List deals (Brevo's lightweight CRM deal/opportunity objects). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-email-campaigns` | List email (classic) campaigns in the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-email-templates` | List the account's transactional email templates. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-senders` | List the account's verified sender email addresses. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-sms-campaigns` | List SMS campaigns in the account, with optional status filtering, sorting and pagination. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-contacts-from-list` | Remove one or more contacts, identified by email, from a Brevo contact list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `schedule-email-campaign` | Schedule a draft email campaign to send at a future date/time. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-email-campaign-now` | Send an existing draft email campaign immediately. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-immediate-campaign` | Create a classic email campaign and send it immediately to the given contact lists in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-transactional-email` | Send a one-off transactional email, either with inline HTML or by rendering a saved template with params. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `subscribe-contact-to-list` | Subscribe an email address to a Brevo contact list, creating the contact if it is new or merging onto the existing contact if it already exists. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `unsubscribe-contact-from-list` | Unsubscribe a contact from a list: removes a single contact, identified by email, from a single list while leaving all other list memberships untouched | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-company` | Update a company's attributes. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-contact-folder` | Rename a contact folder. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-contact-list` | Rename a contact list or move it to a different folder. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-contact` | Update a contact's attributes, list memberships, or blacklist status (partial merge). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-deal` | Update a deal's attributes (name, amount, custom fields). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-email-campaign` | Update a draft or not-yet-sent email campaign. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-email-template` | Update a transactional email template in Brevo | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-sms-campaign` | Update a draft SMS campaign's fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `companies` | Sync Brevo CRM companies, incrementally via the modifiedSince filter with a periodic full refresh to detect deletions. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `contact-lists` | Fetches all Brevo contact lists (metadata only, not list membership) via full refresh. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `contacts` | Sync Brevo contacts, incrementally via the modifiedSince filter with a periodic full refresh to detect deletions. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `deals` | Sync Brevo CRM deals, incrementally via the modifiedSince filter with a periodic full refresh to detect deletions. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `email-campaigns` | Full refresh sync of email (classic) campaigns, including their status and delivery statistics. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `email-templates` | Sync transactional email templates from Brevo (full refresh with delete detection) | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/brevo-api-key.mdx)

## Useful links

* [Generate an API key in your Brevo account](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
* [API documentation](https://developers.brevo.com/reference/getting-started-1)
* [Authentication guide](https://developers.brevo.com/docs/authentication-schemes)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/brevo-api-key.mdx)

## API gotchas

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/brevo-api-key.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.