getbrevo/brevo-php v4.0.11

on GitHub

What's Changed

New features

Events

• Added getEvents() — retrieve a paginated list of custom events, filterable by contactId, eventName, objectType, startDate, and endDate.
  Supports limit (default 100, max 10,000) and offset for pagination.
  Note: currently only supports custom events.
• Added createBatchEvents() — create multiple events in a single request using an array of CreateBatchEventsRequestItem. Returns a BatchAcceptedResponse.

Ecommerce

• CreateUpdateProductRequest and batch product upsert now accept two new optional fields: brand and description.

Balance

• getActiveBalancesApi() now accepts includeInternal to include balances tied to internal definitions.
• getContactBalances() and getSubscriptionBalances() now accept a request object with an includeInternal parameter.
• getTransactionHistory() now supports filtering by status (draft, completed, rejected, cancelled, expired) and transactionType (credit, debit).
• createBalanceDefinition() and updateBalanceDefinition():
  • the meta field is now a typed object (isInternal: bool) instead of a generic key-value array.

CRM

• Added PatchCrmAttributesIdRequest to update CRM attribute labels and selectable option labels.

Changes

Ecommerce

• metaInfo size limit for products clarified: maximum 20,000 characters total (previously documented as 1,000 KB / max 20 items).

Account

• users field on plan verticals is now nullable.

Bug fixes

• createContact() no longer throws a BrevoException
• Checks if the response body is empty and returns null instead of trying to deserialize it
• Only calls CreateContactResponse::fromJson($json) when there's actual content