Brevo

Availability

Core Standard Plus Pro Enterprise Flex Self-Managed Enterprise PyAirbyte

Support Level

Marketplace

Connector Version

0.2.32 (last updated 10 hours ago)

Definition ID

e2276f19-1c19-4d4e-ae6c-7df3c9c4ad49

This page contains the setup guide and reference information for the Brevo source connector.

Brevo (formerly Sendinblue) is a marketing platform that provides email, SMS, CRM, and automation tools. This connector syncs contacts, companies, deals, campaigns, and related metadata from the Brevo API.

Prerequisites

• A Brevo account. Sign up if you don't have one.
• A user with the API keys permission. Only users with this permission can view or create API keys. See User permissions and permission levels in Brevo for details.
• A Brevo API key (generated in the next step).

Generate an API key

1. Sign in to Brevo and open the API Keys & MCP page.
2. Under the API keys tab, select Generate a new API key.
3. Enter a descriptive name (for example, Airbyte) and select Generate.
4. Copy the key and store it securely. Brevo displays the key only once. If you lose it, generate a new one.

For more details, see Brevo's Create and manage your API keys article.

The key inherits the permissions of the user who created it. Make sure that user has access to the data you want to sync (contacts, CRM, campaigns, and so on).

Set up the Brevo source in Airbyte

1. In the Airbyte UI, add a new source and select Brevo.
2. Enter your API Key.
3. Enter a Start date as a UTC timestamp in the format YYYY-MM-DDTHH:MM:SSZ (for example, 2024-01-01T00:00:00Z). Incremental streams only return records modified on or after this date.
4. Select Set up source and Airbyte verifies the credentials by calling the contacts endpoint.

Configuration reference

Input	Type	Description
api_key	string	Brevo API key. Sent in the api-key request header.
start_date	string	UTC timestamp (YYYY-MM-DDTHH:MM:SSZ) used as the lower bound for incremental streams.

Supported sync modes

The connector supports the following sync modes:

• Full Refresh | Overwrite
• Full Refresh | Append
• Incremental | Append (for streams marked as supporting incremental below)
• Incremental | Append + Deduped (for streams with a primary key that support incremental)

Supported streams

Stream	Primary key	Supports full refresh	Supports incremental
account	organization_id	Yes	No
companies	id	Yes	Yes
companies_attributes		Yes	No
contacts	id	Yes	Yes
contacts_attributes		No	No
contacts_folders	id	Yes	No
contacts_folders_lists	id	Yes	No
contacts_lists	id	Yes	No
contacts_lists_contacts		Yes	Yes
contacts_segments	id	Yes	No
crm_attributes_deals		Yes	No
crm_deals	id	Yes	Yes
crm_notes	id	Yes	Yes
crm_pipeline_details_all	pipeline	Yes	No
crm_pipeline_stages	id	Yes	No
crm_tasks	id	Yes	Yes
crm_tasktypes	id	Yes	No
domains	id	Yes	No
emailCampaigns	id	Yes	Yes
organization_invited_users	email	Yes	No
senders	id	Yes	No
smsCampaigns	id	Yes	Yes
webhooks	id	Yes	No

Incremental streams pass the cursor value to Brevo as a modifiedSince query parameter so that only records modified on or after that timestamp are returned.

Performance considerations

Brevo enforces per-endpoint rate limits that vary by account tier. On the general tier available to all accounts, endpoints under /v3/contacts/… allow 10 requests per second, while most other endpoints this connector uses (CRM, campaigns, senders, domains, webhooks, account, organization) share a limit of 100 requests per hour. See Brevo's rate limits documentation for the full per-tier breakdown.

When Brevo returns 429 Too Many Requests, the connector retries with exponential backoff. If you run other integrations against the same API key, consider creating a dedicated key for Airbyte to avoid contention.

Reference

Config fields reference

Field

Type

Property name

API Key

required

string

api_key

string

start_date

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.2.32	2026-04-28	77161	Update dependencies
0.2.31	2026-04-21	76844	Bump SDM base image to stable 7.17.2
0.2.30	2026-04-01	75946	Bump SDM base image for memory monitor (CDK PR #962)
0.2.29	2026-03-31	75672	Update dependencies
0.2.28	2026-03-24	75312	Update dependencies
0.2.27	2026-02-17	73432	Update dependencies
0.2.26	2026-02-03	72612	Update dependencies
0.2.25	2026-01-20	72057	Update dependencies
0.2.24	2026-01-14	71464	Update dependencies
0.2.23	2025-12-18	70627	Update dependencies
0.2.22	2025-11-25	69949	Update dependencies
0.2.21	2025-11-18	69462	Update dependencies
0.2.20	2025-10-29	68749	Update dependencies
0.2.19	2025-10-21	68272	Update dependencies
0.2.18	2025-10-14	67845	Update dependencies
0.2.17	2025-10-07	67207	Update dependencies
0.2.16	2025-09-30	65648	Update dependencies
0.2.15	2025-08-09	64647	Update dependencies
0.2.14	2025-07-12	63047	Update dependencies
0.2.13	2025-07-05	62527	Update dependencies
0.2.12	2025-06-28	62149	Update dependencies
0.2.11	2025-06-21	61898	Update dependencies
0.2.10	2025-06-15	61447	Update dependencies
0.2.9	2025-05-24	60610	Update dependencies
0.2.8	2025-05-10	59885	Update dependencies
0.2.7	2025-05-05	59652	Fix contact pagination
0.2.6	2025-05-03	58704	Update dependencies
0.2.5	2025-04-24	57576	Set ordering in ascending on incremental streams
0.2.4	2025-04-19	57595	Update dependencies
0.2.3	2025-04-05	57126	Update dependencies
0.2.2	2025-03-29	56622	Update dependencies
0.2.1	2025-03-27	56437	Update contacts pagination page size to 1000
0.2.0	2025-03-24	56369	Fix/Add incremental on Contacts/Crm deals
0.1.8	2025-03-22	55367	Update dependencies
0.1.7	2025-03-01	54874	Update dependencies
0.1.6	2025-02-25	54674	Fix bug authenticator
0.1.5	2025-02-22	54223	Update dependencies
0.1.4	2025-02-15	48282	Update dependencies
0.1.3	2024-11-28	48737	Update pagination
0.1.2	2024-10-29	47922	Update dependencies
0.1.1	2024-10-28	47622	Update dependencies
0.1.0	2024-10-08	46587	Fix Companies stream paginator+ remove incremental
0.0.1	2024-09-11	45382	Initial release by @btkcodedev via Connector Builder