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.
- Sign in to Brevo → SMTP & API → API Keys → Generate a new key.
- Copy the key (starts with xkeysib-).
- 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.
| Operation | Category | What it does |
|---|---|---|
| Add contacts to list | General | Add contacts to a Brevo list by email addresses. |
| Create campaign | General | Create a new email campaign in Brevo. |
| Create contact | General | Create a new contact in Brevo. |
| Create list | General | Create a new contact list in Brevo. |
| Delete contact | General | Delete a contact from Brevo. |
| Get campaign | General | Get email campaign details by ID from Brevo. |
| Get campaign statistics | General | Get statistics for a Brevo email campaign. |
| Get contact | General | Get contact details by email or ID from Brevo. |
| List campaigns | General | List all email campaigns in Brevo. |
| List contacts | General | List all contacts in Brevo. |
| List contact lists | General | List all contact lists in Brevo. |
| Send campaign now | General | Send an email campaign immediately in Brevo. |
| Send transactional email | General | Send a transactional email via Brevo SMTP. |
| Send SMS | General | Send a transactional SMS message via Brevo. |
| Send WhatsApp message | General | Send a WhatsApp message using a Brevo template. |
| Update contact | General | Update an existing contact in Brevo. |
Operations
Add contacts to list
Add contacts to a Brevo list by email addresses.
| Parameter | Required | Type | Description |
|---|---|---|---|
List ID listId | Yes | number | |
Emails (JSON array) emails | Yes | textarea |
Tips
- list_id + emails (array).
Create campaign
Create a new email campaign in Brevo.
| Parameter | Required | Type | Description |
|---|---|---|---|
Campaign name name | Yes | text | |
Subject subject | Yes | text | |
Sender (JSON) sender | Yes | text | |
HTML content htmlContent | Yes | textarea | |
Recipients (JSON) recipients | Yes | textarea | |
Scheduled at (ISO 8601) scheduledAt | No | text |
Create contact
Create a new contact in Brevo.
| Parameter | Required | Type | Description |
|---|---|---|---|
Email email | Yes | text | |
Attributes (JSON) attributes | No | textarea | |
List IDs (JSON array) listIds | No | text | |
Update if exists updateEnabled | No | switch |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
List name name | Yes | text | |
Folder ID folderId | Yes | number |
Tips
- name + folderId (use Get Folders or default to root).
Delete contact
Delete a contact from Brevo.
| Parameter | Required | Type | Description |
|---|---|---|---|
Email or contact ID identifier | Yes | text |
Tips
- Hard-delete. Removes from all lists too.
Get campaign
Get email campaign details by ID from Brevo.
| Parameter | Required | Type | Description |
|---|---|---|---|
Campaign ID campaignId | Yes | text |
Tips
- Returns campaign + recipients + stats.
Get campaign statistics
Get statistics for a Brevo email campaign.
| Parameter | Required | Type | Description |
|---|---|---|---|
Campaign ID campaignId | Yes | text |
Get contact
Get contact details by email or ID from Brevo.
| Parameter | Required | Type | Description |
|---|---|---|---|
Email or contact ID identifier | Yes | text |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Campaign ID campaignId | Yes | text |
Send transactional email
Send a transactional email via Brevo SMTP.
| Parameter | Required | Type | Description |
|---|---|---|---|
Sender (JSON) sender | Yes | text | |
To (JSON array) to | Yes | textarea | |
Subject subject | Yes | text | |
HTML content htmlContent | Yes | textarea | |
Text content textContent | No | textarea | |
Tags (comma-separated) tags | No | text |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Sender name sender | Yes | text | |
Recipient phone recipient | Yes | text | |
Message content content | Yes | textarea | |
Type (transactional/marketing) type | Yes | text |
Send WhatsApp message
Send a WhatsApp message using a Brevo template.
| Parameter | Required | Type | Description |
|---|---|---|---|
Sender number senderNumber | Yes | text | |
Contact numbers (JSON array) contactNumbers | Yes | textarea | |
Template ID templateId | Yes | number | |
Template parameters (JSON) templateParams | No | textarea |
Update contact
Update an existing contact in Brevo.
| Parameter | Required | Type | Description |
|---|---|---|---|
Email or contact ID identifier | Yes | text | |
Attributes (JSON) attributes | No | textarea | |
List IDs (JSON array) listIds | No | text |
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.