Brevo integration

Marketing platform: email campaigns, transactional email, contacts, lists, SMS, WhatsApp (formerly Sendinblue)

Help CentreConnectors

Overview

Brevo (formerly Sendinblue) is a marketing + transactional email platform with strong SMS + CRM features. The Automize Brevo connector covers email campaigns, contacts/lists, transactional sends, SMS, and templates.

  • Regions: Brevo is a single global service – api.brevo.com. EU data residency available on Enterprise.
  • Plans: Free, Starter, Business, Enterprise – all expose the API. SMS requires top-up credits.

Setting up the connection

Auth type: API Key.

  1. Sign in to Brevo → SMTP & API → API Keys → Generate a new key.
  2. Copy the key (starts with xkeysib-).
  3. In Automize, open Settings → Connectors → Brevo → Add connection. Paste the key.

Find your credentials at https://app.brevo.com/settings/keys/api.


Rate limits

Brevo enforces 400 requests/sec across the account (plus per-endpoint thresholds). Connector retries 429 with backoff.


Data model

Brevo's primitives:

    Account ─┬─ Contacts ─── Lists (folders of contacts)
             ├─ Email Campaigns
             ├─ Templates (transactional + marketing)
             ├─ SMS Campaigns
             └─ Transactional sends (one-off triggered)

Available operations

16 operations available. Click any row to jump to its detail.

OperationCategoryWhat it does
Add contacts to listGeneralAdd contacts to a Brevo list by email addresses.
Create campaignGeneralCreate a new email campaign in Brevo.
Create contactGeneralCreate a new contact in Brevo.
Create listGeneralCreate a new contact list in Brevo.
Delete contactGeneralDelete a contact from Brevo.
Get campaignGeneralGet email campaign details by ID from Brevo.
Get campaign statisticsGeneralGet statistics for a Brevo email campaign.
Get contactGeneralGet contact details by email or ID from Brevo.
List campaignsGeneralList all email campaigns in Brevo.
List contactsGeneralList all contacts in Brevo.
List contact listsGeneralList all contact lists in Brevo.
Send campaign nowGeneralSend an email campaign immediately in Brevo.
Send transactional emailGeneralSend a transactional email via Brevo SMTP.
Send SMSGeneralSend a transactional SMS message via Brevo.
Send WhatsApp messageGeneralSend a WhatsApp message using a Brevo template.
Update contactGeneralUpdate an existing contact in Brevo.

Operations

Add contacts to list

Add contacts to a Brevo list by email addresses.

ParameterRequiredTypeDescription
List ID listIdYesnumber
Emails (JSON array) emailsYestextarea

Tips

  • list_id + emails (array).

Create campaign

Create a new email campaign in Brevo.

ParameterRequiredTypeDescription
Campaign name nameYestext
Subject subjectYestext
Sender (JSON) senderYestext
HTML content htmlContentYestextarea
Recipients (JSON) recipientsYestextarea
Scheduled at (ISO 8601) scheduledAtNotext

Create contact

Create a new contact in Brevo.

ParameterRequiredTypeDescription
Email emailYestext
Attributes (JSON) attributesNotextarea
List IDs (JSON array) listIdsNotext
Update if exists updateEnabledNoswitch

Tips

  • email + attributes (custom field dict).
  • listIds[] to add to lists immediately.

Errors

  • Contact already exist – Use Update Contact instead. Brevo doesn't auto-upsert.

Create list

Create a new contact list in Brevo.

ParameterRequiredTypeDescription
List name nameYestext
Folder ID folderIdYesnumber

Tips

  • name + folderId (use Get Folders or default to root).

Delete contact

Delete a contact from Brevo.

ParameterRequiredTypeDescription
Email or contact ID identifierYestext

Tips

  • Hard-delete. Removes from all lists too.

Get campaign

Get email campaign details by ID from Brevo.

ParameterRequiredTypeDescription
Campaign ID campaignIdYestext

Tips

  • Returns campaign + recipients + stats.

Get campaign statistics

Get statistics for a Brevo email campaign.

ParameterRequiredTypeDescription
Campaign ID campaignIdYestext

Get contact

Get contact details by email or ID from Brevo.

ParameterRequiredTypeDescription
Email or contact ID identifierYestext

Tips

  • Identifier: email, id, or sms (with country code).

List campaigns

List all email campaigns in Brevo.

No input parameters.

Tips

  • Filter by status (draft, sent, scheduled). type=classic / trigger.

List contacts

List all contacts in Brevo.

No input parameters.

Tips

  • Page via limit + offset (max limit=1000).
  • filter parameter: modifiedSince to delta-sync.

List contact lists

List all contact lists in Brevo.

No input parameters.

Tips

  • Returns lists in folders. Page via limit + offset.

Send campaign now

Send an email campaign immediately in Brevo.

ParameterRequiredTypeDescription
Campaign ID campaignIdYestext

Send transactional email

Send a transactional email via Brevo SMTP.

ParameterRequiredTypeDescription
Sender (JSON) senderYestext
To (JSON array) toYestextarea
Subject subjectYestext
HTML content htmlContentYestextarea
Text content textContentNotextarea
Tags (comma-separated) tagsNotext

Tips

  • Transactional send (not a campaign). sender + to + subject + htmlContent OR templateId + params.
  • params: dict for template variable substitution.

Send SMS

Send a transactional SMS message via Brevo.

ParameterRequiredTypeDescription
Sender name senderYestext
Recipient phone recipientYestext
Message content contentYestextarea
Type (transactional/marketing) typeYestext

Send WhatsApp message

Send a WhatsApp message using a Brevo template.

ParameterRequiredTypeDescription
Sender number senderNumberYestext
Contact numbers (JSON array) contactNumbersYestextarea
Template ID templateIdYesnumber
Template parameters (JSON) templateParamsNotextarea

Update contact

Update an existing contact in Brevo.

ParameterRequiredTypeDescription
Email or contact ID identifierYestext
Attributes (JSON) attributesNotextarea
List IDs (JSON array) listIdsNotext

Tips

  • PATCH on attributes. listIds + unlinkListIds to manage list memberships.

FAQ

Brevo vs Sendinblue – same?
Yes – Brevo is the rebranded Sendinblue (renamed 2023). Same API.
Why does Create Contact fail with 'already exists'?
Brevo doesn't auto-upsert. Use Update Contact (it creates if not exists when called with updateEnabled=true).
How do I track template variables?
Pass params={FNAME: 'Alice', PROMO: 'SUMMER25'} in Send Email. Use {{ params.FNAME }} syntax inside the template content.

Related connectors

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.