Changelog

Brevo CLI v2.0.0 — upgrade notice

The Brevo CLI (@getbrevo/cli) has a new major version, 2.0.0, which introduces breaking changes. If you are on v1.1.1 or earlier, migrate to 2.0.0 — some commands may not work as expected on older…

improvedbreaking

Deals API — filter by owner, stage, and pipeline

GET /crm/deals now documents three additional query filters, so you can narrow results server-side instead of fetching every deal and filtering client-side: filters[attributes.deal_owner] — filter by…

improvedbreaking

Consent Groups API and Wallet pass install URLs

New endpoints and fields have been added to the API for managing consent groups and generating wallet pass installation URLs.

added

OAuth apps now support scopes

OAuth apps can now declare scopes — the specific permissions your app requests from a Brevo user. Scopes are shown to the user on the consent screen and embedded in the issued access token, so your…

added

Major SDK releases: Node.js v6.0.0, PHP v5.0.0, Python v5.0.0

We've released the next major version of our three official SDKs. These are opt-in major releases with breaking changes — your existing v4.x/v5.x integrations are not affected unless you upgrade.

addedbreaking

Deprecation Notice: POST /contacts/batch

Effective: 30 October 2026 The Update Multiple Contacts endpoint (POST /contacts/batch) will be deprecated on 30 October 2026. This endpoint is being replaced by the newer and more scalable POST…

deprecated

Contacts category attributes: valueStr field, and Ecommerce product search and alternative price

Breaking changes Get contact attributes — The value (integer) field in category-type attribute enumerations now returns 0 for non-numeric values (e.g. language codes "en", "fr"). Previously these…

addedbreaking

Coupons webhooks documentation

Marketing Webhooks — Added a new Coupons webhooks section documenting the unique_coupon_sent event. This event is triggered when a unique coupon code is sent to a contact from a coupon collection,…

added

Batch events body wrapper, contact merge ID response, and loyalty transaction filter

Breaking changes Batch track events (POST /events/batch) — The request body schema has changed. The array of events must now be wrapped in an object under an events key. Previously accepted: [{...},…

addedbreaking

API specification overhaul: accuracy, completeness, and breaking corrections

This release reflects a major rework of the OpenAPI specification to bring it in line with actual API behavior. Some changes correct inaccuracies between the spec and the responses, some generated…

improvedfixedbreaking

SDK bug fixes: Node.js v5.0.5, PHP v4.0.14, Python v4.0.11

Fixed Process endpoints — duplicate_email_id is now typed as a string (URL to a CSV file) instead of an integer. The legacy in_process status value is now handled correctly across all SDKs. Event…

fixed

SDK updates: Node.js v5.0.3, PHP v4.0.11, Python v4.0.9

New endpoints, new fields, and API improvements across all three SDKs.

addedimproved

Ecommerce, Events, and Loyalty API updates

Ecommerce — New product fields Two new fields are now supported on the POST /products and POST /products/batch endpoints, as well as the GET /products/{id} response: brand — Brand name of the…

addedimprovedbreaking

SDK updates: Node.js v5.0.1, PHP v4.0.10, Python v4.0.7

Bug fixes, type corrections, and a deprecation across all three SDKs.

improvedfixeddeprecated

Loyalty API guides

Added a new Loyalty section to the Guides tab with six pages covering the full Loyalty API integration workflow. Overview — key concepts, data model, and transaction lifecycle Set up a program —…

added

Batch event creation

Added POST /events/batch to the Events API. This endpoint allows sending multiple events in a single request, each with its own contact identifiers, event properties, and optional object…

added

Brevo MCP server — security and configuration update

The Brevo MCP server has been updated with improved security, simplified maintenance, and rate limiting. What changed: Authentication method: MCP tokens are no longer passed in the URL. They are now…

improved

Loyalty API: new endpoint and rate limits

New endpoint: DELETE /loyalty/config/programs/{pid}/contact/{cid} Removes a contact from a loyalty program subscription. See the Loyalty API reference for details. Rate limits: Loyalty endpoints now…

addedimproved

Python SDK v4 beta release

We've released a beta version of the Python SDK (v4.0) with significant improvements including native async support via AsyncBrevo, Pydantic-based typed models, automatic retries with exponential…

added

Conversations webhooks documentation update

Updated the Conversations webhooks documentation with new fields and corrections. Message object — new fields: rawUnsafeHtml — Raw unsanitized HTML of the message subject — Email subject line…

improved