Brevo API Documentation
This is the complete API documentation for connecting to the Brevo API using MindCloud's Universal API. If you are new to MindCloud, start with the Introduction to see how one API can sit in front of many different apps.
MindCloud is an integration company that offers one normalized API to access 3,100+ apps from a single place. It cleans up provider-specific quirks, keeps requests and responses consistent, and centralizes authentication so you do not need to manage separate flows for every app. Browse other apps.
Meet Brevo: Manage contacts, automate campaigns, send messages, and grow customer relationships. Keep reading to get started.
Quickstart
Before you run your first Brevo request, you need three things:
- A MindCloud account — sign in or create an account at MindCloud.
- A MindCloud API Key — create one in API Keys. Keep it on your server.
- At least one Brevo connection — create or choose one in Connections. Note its
connectionId.
Every Brevo action uses the same URL pattern:
https://connect.mindcloud.co/v1/universal/brevo/latest/actions/{actionSlug}You need a MindCloud API Key and a Brevo connection. Then call an action such as Get Account:
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/brevo/latest/actions/get-account" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID"Every response comes back in the same envelope, with your rows in a data array:
{
"success": true,
"data": [
{ "id": "1042", "name": "Ava" }
],
"meta": {}
}After your first request works, use Shape your requests to control arguments, pagination, filtering, fields, and errors.
Authentication
Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Brevo account that should run the action. MindCloud stores and refreshes the Brevo credentials behind that connection, so you never send provider tokens with your requests.
Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions. Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs.
Brevo actions
All 285 published actions for this Brevo version. Each page documents the endpoint, arguments, and response controls.
- POSTActivate Ecommerce
- POSTAdd Contacts to List
- POSTAssign Loyalty Tier
- POSTAssociate Corporate Sub Account IP
- PUTAuthenticate Sender Domain
- POSTCancel Loyalty Transaction
- POSTComplete Loyalty Redeem Transaction
- POSTComplete Loyalty Transaction
- POSTCreate Blocked Domain
- POSTCreate Categories Batch
- POSTCreate Category
- POSTCreate Company
- POSTCreate Contact
- POSTCreate Contact Attribute
- POSTCreate Contact Folder
- POSTCreate Contacts Batch
- POSTCreate Conversation Message
- POSTCreate Corporate Group
- POSTCreate Corporate SSO Token
- POSTCreate Corporate Sub Account
- POSTCreate Corporate Sub Account API Key
- POSTCreate Corporate Sub Account SSO Token
- POSTCreate Coupon Collection
- POSTCreate Coupons
- POSTCreate CRM Attribute
- POSTCreate CRM File
- POSTCreate CRM Note
- POSTCreate CRM Task
- POSTCreate Deal
- POSTCreate Email Campaign
- POSTCreate Event
- POSTCreate Events Batch
- POSTCreate Feed
- POSTCreate List
- POSTCreate Loyalty Balance Definition
- POSTCreate Loyalty Balance Limit
- POSTCreate Loyalty Order
- POSTCreate Loyalty Program
- POSTCreate Loyalty Reward
- POSTCreate Loyalty Subscription Balances
- POSTCreate Loyalty Subscription Member
- POSTCreate Loyalty Tier
- POSTCreate Loyalty Tier Group
- POSTCreate Loyalty Transaction
- POSTCreate Loyalty Voucher
- POSTCreate Order Status
- POSTCreate Orders Batch
- POSTCreate Payment Request
- POSTCreate Product
- POSTCreate Product Alert
- POSTCreate Products Batch
- POSTCreate Pushed Conversation Message
- POSTCreate Sender
- POSTCreate Sender Domain
- POSTCreate SMS Campaign
- POSTCreate SMTP Template
- POSTCreate Webhook
- POSTCreate WhatsApp Campaign
- POSTCreate WhatsApp Template
- DELETEDelete Blocked Contact
- DELETEDelete Blocked Domain
- DELETEDelete Company
- DELETEDelete Contact
- DELETEDelete Contact Attribute
- DELETEDelete Contact Attribute Option
- DELETEDelete Contact Folder
- DELETEDelete Conversation Message
- DELETEDelete Corporate Group
- DELETEDelete Corporate Sub Account
- DELETEDelete CRM Attribute
- DELETEDelete CRM File
- DELETEDelete CRM Note
- DELETEDelete CRM Task
- DELETEDelete Deal
- DELETEDelete Email Campaign
- DELETEDelete Feed
- POSTDelete Hard Bounces
- DELETEDelete List
- DELETEDelete Loyalty Balance Definition
- DELETEDelete Loyalty Balance Limit
- DELETEDelete Loyalty Contact Subscription
- DELETEDelete Loyalty Program
- DELETEDelete Loyalty Subscription Members
- DELETEDelete Loyalty Tier
- DELETEDelete Loyalty Tier Group
- DELETEDelete Object Records Batch
- DELETEDelete Payment Request
- DELETEDelete Pushed Conversation Message
- DELETEDelete Scheduled Email
- DELETEDelete Sender
- DELETEDelete Sender Domain
- DELETEDelete SMS Campaign
- DELETEDelete SMTP Log
- DELETEDelete SMTP Template
- DELETEDelete Webhook
- DELETEDelete WhatsApp Campaign
- PUTDissociate Corporate Sub Account IP
- POSTExport Contacts
- POSTExport Email Campaign Recipients
- POSTExport SMS Campaign Recipients
- POSTExport Webhook History
- GETGet Account
- GETGet Category
- GETGet Company
- GETGet Contact
- GETGet Contact Campaign Stats
- GETGet Contact Folder
- GETGet Conversation Message
- GETGet Corporate Group
- GETGet Corporate Invited User Permissions
- GETGet Corporate Sub Account
- GETGet Corporate User Permissions
- GETGet Coupon Collection
- GETGet CRM File
- GETGet CRM File Metadata
- GETGet CRM Note
- GETGet CRM Pipeline
- GETGet CRM Task
- GETGet Deal
- GETGet Ecommerce Attribution Metric Detail
- GETGet Ecommerce Display Currency
- GETGet Email Campaign
- GETGet Email Campaign AB Test Result
- GETGet Email Campaign Shared URL
- GETGet Feed
- GETGet Inbound Attachment
- GETGet Inbound Event
- GETGet List
- GETGet Loyalty Active Balances
- GETGet Loyalty Balance Definition
- GETGet Loyalty Balance Limit
- GETGet Loyalty Code Count
- GETGet Loyalty Offers
- GETGet Loyalty Program
- GETGet Loyalty Programs
- GETGet Loyalty Reward
- GETGet Loyalty Subscription Balances
- GETGet Loyalty Subscription Data
- GETGet Loyalty Tier Group
- GETGet Loyalty Vouchers
- GETGet Master Account
- GETGet Organization User Permissions
- GETGet Payment Request
- GETGet Process
- GETGet Product
- GETGet Pushed Conversation Message
- GETGet Scheduled Email
- GETGet Sender Domain
- GETGet SMS Campaign
- GETGet SMTP Aggregated Report
- GETGet SMTP Template
- GETGet Transactional Email Content
- GETGet Transactional SMS Aggregated Report
- GETGet Webhook
- GETGet WhatsApp Campaign
- GETGet WhatsApp Campaign Config
- POSTImport Companies
- POSTImport Contacts
- POSTImport Deals
- POSTInvite Corporate Admin User
- POSTInvite Organization User
- PUTLink Unlink Company
- PUTLink Unlink Deal
- GETList Blocked Contacts
- GETList Blocked Domains
- GETList Categories
- GETList Companies
- GETList Contact Attributes
- GETList Contact Folders
- GETList Contacts
- GETList Contacts in List
- GETList Corporate Groups
- GETList Corporate Invited Users
- GETList Corporate IPs
- GETList Corporate Sub Accounts
- GETList Coupon Collections
- GETList CRM Company Attributes
- GETList CRM Deal Attributes
- GETList CRM Files
- GETList CRM Notes
- GETList CRM Pipeline Details
- GETList CRM Pipelines
- GETList CRM Task Types
- GETList CRM Tasks
- GETList Deals
- GETList Ecommerce Attributed Products
- GETList Ecommerce Attribution Metrics
- GETList Email Campaigns
- GETList Events
- GETList Feeds
- GETList Inbound Events
- GETList Lists
- GETList Lists in Folder
- GETList Loyalty Balance Definitions
- GETList Loyalty Contact Balances
- GETList Loyalty Tier Groups
- GETList Loyalty Tiers
- GETList Loyalty Transaction History
- GETList Object Records
- GETList Orders
- GETList Organization Activities
- GETList Organization Invited Users
- GETList Processes
- GETList Products
- GETList Segments
- GETList Sender Domains
- GETList Sender IPs
- GETList Sender IPs by Sender
- GETList Senders
- GETList SMS Campaigns
- GETList SMS Templates
- GETList SMTP Events
- GETList SMTP Reports
- GETList SMTP Templates
- GETList Transactional Emails
- GETList Transactional SMS Events
- GETList Transactional SMS Reports
- GETList Webhooks
- GETList WhatsApp Campaigns
- GETList WhatsApp Events
- GETList WhatsApp Templates
- PUTPartially Update Loyalty Program
- POSTPing Conversation Agent Online
- POSTPreview SMTP Template
- POSTPublish Loyalty Program
- POSTRedeem Loyalty Voucher
- DELETERemove Contacts from List
- DELETERevoke Corporate User
- DELETERevoke Loyalty Vouchers
- PUTRevoke Organization User Permission
- POSTSend Async Transactional SMS
- POSTSend Double Opt-In Confirmation
- POSTSend Email Campaign Now
- POSTSend Email Campaign Report
- POSTSend Email Campaign Test
- POSTSend SMS Campaign Now
- POSTSend SMS Campaign Report
- POSTSend SMS Campaign Test
- POSTSend SMTP Template Test
- POSTSend Transactional Email
- POSTSend Transactional SMS
- POSTSend WhatsApp Message
- POSTSend WhatsApp Template Approval
- POSTSubscribe Loyalty Program
- PUTToggle Corporate Sub Account Applications
- PUTUnlink Corporate Group Sub Accounts
- PUTUpdate Company
- PUTUpdate Contact
- PUTUpdate Contact Attribute
- PUTUpdate Contact Folder
- PUTUpdate Conversation Message
- PUTUpdate Conversation Visitor Group
- PUTUpdate Corporate Group
- PUTUpdate Corporate Sub Account Plan
- PUTUpdate Corporate Sub Accounts Plan
- PUTUpdate Corporate User Invitation
- PUTUpdate Corporate User Permissions
- PUTUpdate Coupon Collection
- PUTUpdate CRM Attribute
- PUTUpdate CRM Note
- PUTUpdate CRM Task
- PUTUpdate Deal
- PUTUpdate Ecommerce Display Currency
- PUTUpdate Email Campaign
- PUTUpdate Email Campaign Status
- PUTUpdate Feed
- PUTUpdate List
- PUTUpdate Loyalty Balance Definition
- PUTUpdate Loyalty Balance Limit
- PUTUpdate Loyalty Program
- PUTUpdate Loyalty Tier
- PUTUpdate Loyalty Tier Group
- PUTUpdate Organization User Invitation
- PUTUpdate Organization User Permissions
- PUTUpdate Pushed Conversation Message
- PUTUpdate Sender
- PUTUpdate SMS Campaign
- PUTUpdate SMS Campaign Status
- PUTUpdate SMTP Template
- PUTUpdate Webhook
- PUTUpdate WhatsApp Campaign
- POSTUpload Email Campaign Image
- POSTUpsert Object Records Batch
- POSTValidate Loyalty Reward
- PUTValidate Sender
Related apps
More Marketing apps on the Universal API, behind the same REST shape. Or browse all apps.