brevo

name

brevo

description

Brevo is an all-in-one marketing and CRM platform that enables businesses to run email, SMS, WhatsApp and chat campaigns, automate customer journeys, manage sales pipelines, and integrate data across channels for unified audience engagement. Read and write Brevo data through One: contacts, emailcampaigns, smscampaigns, resellerchildren, loyaltyprograms, companies and more, 288 actions with real parameter documentation. Use whenever the user asks to look something up in Brevo, create or update a record there, or build code against the Brevo API.

Brevo through One

Brevo is an all-in-one marketing and CRM platform that enables businesses to run email, SMS, WhatsApp and chat campaigns, automate customer journeys, manage sales pipelines, and integrate data across channels for unified audience engagement.

One exposes Brevo through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform brevo if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Brevo is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Brevo account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Contacts

Action	Method	Path	Action id
Get a Contact’s Details	GET	/contacts/{{identifier}}	conn_mod_def::GJ09BwbiHkw::G1j_lOjfQPyvuIc3aXmd8w
Get a Contact’s Email Campaign Statistics	GET	/contacts/{{identifier}}/campaignStats	conn_mod_def::GJ09CqaUqR8::EfQYWFfuTNmtZyGIle0gVg
List All Contacts	GET	/contacts	conn_mod_def::GJ09CJEa-ls::HzOZBGjzTAuGJTBiSexohA
List Contacts in a List	GET	/contacts/lists/{{listId}}/contacts	conn_mod_def::GJ09CiRwPzo::k_QH3ardSvKyCjDch8pybA
Create a Contact	POST	/contacts	conn_mod_def::GJ09AOjcvK0::xkt-oI9RSKWZa0BhrMVTHg
Create a Contact via Double Opt-In (DOI) Confirmation	POST	/contacts/doubleOptinConfirmation	conn_mod_def::GJ09At1chYQ::AmwXIGyOQCSyvM1fCjKVOA
Delete a Contact	DELETE	/contacts/{{identifier}}	conn_mod_def::GJ09A2PLVT8::ihKYVRoRQ32Pu4-4M5FvQA
Export Contacts (Background Process)	POST	/contacts/export	conn_mod_def::GJ09BlCf6YY::CWlKGb9iRDS0aWGjSyZu9g
Import Contacts	POST	/contacts/import	conn_mod_def::GJ09C50u6is::ngyPSaGQTKu7kdY4FKQ4hA
Remove Contacts from a List	POST	/contacts/lists/{{listId}}/contacts/remove	conn_mod_def::GJ09A9PRRcw::34mYMzA3R5KvdrYrYm6ggw
Update a Contact (by Identifier)	PUT	/contacts/{{identifier}}	conn_mod_def::GJ09DUNIep4::hnVE5-MxQ0OoVn-JDW7Rlg
Update Multiple Contacts (Batch)	POST	/contacts/batch

EmailCampaigns

Action	Method	Path	Action id
Get an A/B Test Email Campaign Results	GET	/emailCampaigns/{{campaignId}}/abTestCampaignResult	conn_mod_def::GJ09QH2dOKg::8GkR8APFQ4yv3RyiGkGosg
Get an Email Campaign Report	GET	/emailCampaigns/{{campaignId}}	conn_mod_def::GJ09QQIJdho::ybnN9MRKTvyJs2FDnfDCLg
Get an Email Campaign's Shared Template URL	GET	/emailCampaigns/{{campaignId}}/sharedUrl	conn_mod_def::GJ09P1bOFI4::0Ftm_bKzROus4l7B1w9gOw
List Email Campaigns	GET	/emailCampaigns	conn_mod_def::GJ09QrOgos0::mP7yfkmZR92JmqRj3ykRKQ
Create an Email Campaign	POST	/emailCampaigns	conn_mod_def::GJ09O3ifZaA::HSb6y-w1Sned8yCy8sVsLg
Delete an Email Campaign	DELETE	/emailCampaigns/{{campaignId}}	conn_mod_def::GJ09PUHS3Nc::PZ81qRM7RuGdgZ7SvL3vIA
Send a Test Email for an Email Campaign	POST	/emailCampaigns/{{campaignId}}/sendTest	conn_mod_def::GJ09RjLGeLc::FKA53f7NQJOgsJEyTr9teA
Send an Email Campaign Now	POST	/emailCampaigns/{{campaignId}}/sendNow	conn_mod_def::GJ09Rbmwb4Y::yQj4rHD4Tninwy4LyIO09g
Send an Email Campaign's Report	POST	/emailCampaigns/{{campaignId}}/sendReport	conn_mod_def::GJ09RzhwUU0::9A6kmCWuSIGogbh1jGG9rQ
Update an Email Campaign	PUT	/emailCampaigns/{{campaignId}}	conn_mod_def::GJ09SeptU3E::Bke-N8BeRka2GxBzg9JDiA
Update an Email Campaign’s Status	PUT	/emailCampaigns/{{campaignId}}/status	conn_mod_def::GJ09SmdDVFg::ay9q1OTnR7WSKXhuW6FiOQ

SmsCampaigns

Action	Method	Path	Action id
Get an SMS Campaign	GET	/smsCampaigns/{{campaignId}}	conn_mod_def::GJ09QXbZFmk::fN8ky97_QGWquTfrEk2wYA
List SMS Campaigns	GET	/smsCampaigns	conn_mod_def::GJ09RIMG--U::2qY5j5tISI6qNkGTjPu9GA
Create an SMS Campaign	POST	/smsCampaigns	conn_mod_def::GJ09PGOHYSQ::yEJ4MKkFRQm34wEHkhYjfw
Delete an SMS Campaign	DELETE	/smsCampaigns/{{campaignId}}	conn_mod_def::GJ09PdYfDXw::tqus5a6MTfaV-ngQTqh35Q
Send a Test SMS Campaign	POST	/smsCampaigns/{{campaignId}}/sendTest	conn_mod_def::GJ09RSVnjro::Sr1sypiWRIaCrbc_szdjsw
Send an SMS Campaign Immediately (Send Now)	POST	/smsCampaigns/{{campaignId}}/sendNow	conn_mod_def::GJ09R7MRFGU::cV7CVv90RPOmCFbTBxqpoQ
Send an SMS Campaign's Report	POST	/smsCampaigns/{{campaignId}}/sendReport	conn_mod_def::GJ09RrfgPqs::6VWNmu7nTZyzNfDvWDqPNQ
Update an SMS Campaign	PUT	/smsCampaigns/{{campaignId}}	conn_mod_def::GJ09StlpVWw::IFB9RLRYQOyTkemEg8qGcw
Update an SMS Campaign's Status	PUT	/smsCampaigns/{{campaignId}}/status	conn_mod_def::GJ09SNNtcCA::VapQgYV2R8arkBBM9DOSGA

ResellerChildren

Action	Method	Path	Action id
Get a Reseller Child Account Creation Status	GET	/reseller/children/{{childIdentifier}}/accountCreationStatus	conn_mod_def::GJ089HDqA2g::VlIGBibjQyafBPYUAz0UCw
Get a Reseller Child Account’s Details	GET	/reseller/children/{{childIdentifier}}	conn_mod_def::GJ086owqmBM::FxyhtYdUTzW0gw8atoPXfA
List a Reseller’s Children Accounts	GET	/reseller/children	conn_mod_def::GJ088SBx9qg::5qZ66kmIT2eD-iVi4atOuQ
Create a Reseller Child	POST	/reseller/children	conn_mod_def::GJ084kpEXZY::_2ttdGUpR_u1mzIKj2-rZQ
Delete a Reseller Child	DELETE	/reseller/children/{{childIdentifier}}	conn_mod_def::GJ085BaiP4Q::rL6KL-sKS_ChWCwfBasEPA
Update a Reseller Child Account’s Status	PUT	/reseller/children/{{childIdentifier}}/accountStatus	conn_mod_def::GJ08_L4VHng::YJV_LD5CQia6Z2bfOhLlJw
Update a Reseller Child's Info	PUT	/reseller/children/{{childIdentifier}}	conn_mod_def::GJ08_TUYjbk::b22aEy3BSFuxq-kIBdCw6w

LoyaltyPrograms

Action	Method	Path	Action id
Get a Loyalty Program’s Info	GET	/loyalty/config/programs/{{loyaltyProgramId}}	conn_mod_def::GJ09L4_w7ek::U6NTOGgtRQmwa4b00BLj_Q
List Loyalty Programs	GET	/loyalty/config/programs	conn_mod_def::GJ09MFL-3j4::JJ1l92xlT9WTO4AmqaT10A
Create a Loyalty Program	POST	/loyalty/config/programs	conn_mod_def::GJ09JOmUu24::OVd0ZxpjRD6Dba8_vvOkPw
Delete a Loyalty Program	DELETE	/loyalty/config/programs/{{loyaltyProgramId}}	conn_mod_def::GJ09KZ0pCPY::V_o4j_gyTueqeU7dsOUjrg
Partially Update a Loyalty Program	PATCH	/loyalty/config/programs/{{loyaltyProgramId}}	conn_mod_def::GJ09NmlNsno::cnlKSWijTr-N-scRZ3VqTA
Publish a Loyalty Program	POST	/loyalty/config/programs/{{loyaltyProgramId}}/publish	conn_mod_def::GJ09NuY2i3c::EU6esVmsRRKulgoP55-mGQ
Update a Loyalty Program	PUT	/loyalty/config/programs/{{loyaltyProgramId}}	conn_mod_def::GJ09OF4lOi0::OgjsmUmMQvysL3Nf8sLW7g

Companies

Action	Method	Path	Action id
Get a Company	GET	/companies/{{id}}	conn_mod_def::GJ09UqM1Lkk::mzOHIu1nQpye1HHikraklw
List Companies	GET	/companies	conn_mod_def::GJ09VNWy4GY::9VMC1ad8QEyCIr27GdMcFA
Create a Company	POST	/companies	conn_mod_def::GJ09TUz0zCw::ZlmfpN4HT4O0X2qkHD1B3w
Delete a Company	DELETE	/companies/{{id}}	conn_mod_def::GJ09T7HLliE::jZQywLAKQlCUUN7EtM6L0g
Import Companies (Creation and Updation)	POST	/companies/import	conn_mod_def::GJ09Wct9Cgc::YDTWtaGEShOveeAgDm6b5Q
Link and Unlink a Company with Contacts and Deals	PATCH	/companies/link-unlink/{{id}}	conn_mod_def::GJ09WtDxcH8::TKaf88xdQ7uCq_49st7liQ
Update a Company	PATCH	/companies/{{id}}	conn_mod_def::GJ09W0TO3Xw::n2GVj9DJTdSxeZd5y_xxPw

Webhooks

Action	Method	Path	Action id
Get a Webhook’s Details	GET	/webhooks/{{webhookId}}	conn_mod_def::GJ0866EVZQM::Mm_IlYaqROODWDFqten4fQ
List All Webhooks	GET	/webhooks	conn_mod_def::GJ087aUZHQs::YPlotCwgRNC5wDHxXhPSaQ
Create a Webhook	POST	/webhooks	conn_mod_def::GJ084MOIb6U::C2ynn0bOS0yj7je-ELOvVg
Delete a Webhook	DELETE	/webhooks/{{webhookId}}	conn_mod_def::GJ085O3L040::rLqeBZRFR4uXepYQU5j_Eg
Export All Webhook Events	POST	/webhooks/export	conn_mod_def::GJ086KcIph4::V_1zQJYgQF2WyZ1FWoh22A
Update a Webhook	PUT	/webhooks/{{webhookId}}	conn_mod_def::GJ08-5lfgo0::K1-XFtmkRgKLd4Bh22yTTQ

Senders

Action	Method	Path	Action id
List a Sender’s Dedicated IPs	GET	/senders/{{senderId}}/ips	conn_mod_def::GJ087LHpn7c::ENWHV5f3RGyzI71mes9tGw
List All Senders	GET	/senders	conn_mod_def::GJ088tTFaRA::PXXtVmU9QMejN3umm_pzOA
Create a New Sender	POST	/senders	conn_mod_def::GJ0838xUO_E::UgQTYgUcSYeiZfw2xxCE6g
Delete a Sender	DELETE	/senders/{{senderId}}	conn_mod_def::GJ0846w8C-w::YmihI3VdT-KuC3bnITkc4Q
Update a Sender	PUT	/senders/{{senderId}}	conn_mod_def::GJ08-ycu3zA::dxVKTyYQS26EX0H8PUk3CQ
Validate a Sender Using OTP	PUT	/senders/{{senderId}}/validate	conn_mod_def::GJ09AAObxvA::mcN7Y7QvRS2QvIDn0nItYA

WhatsappCampaigns

Action	Method	Path	Action id
Create a WhatsApp Template	GET	/whatsappCampaigns/template	conn_mod_def::GJ09Ov-y9YE::C4pvYOq5RR-h6QcxgmSyIQ
Get Your WhatsApp API Account Information	GET	/whatsappCampaigns/config	conn_mod_def::GJ09Qf2EyQI::iEMqbtnxQTmWsNoLxwB9HA
List WhatsApp Campaigns	GET	/whatsappCampaigns	conn_mod_def::GJ09Q0lCmvE::PXK1ilS_SQ-e-zgI5aB7qQ
Create and Send a WhatsApp Campaign	POST	/whatsappCampaigns	conn_mod_def::GJ09O-pyMX4::_HvkgZS5RmqMdxQzaGBYhw
Send a WhatsApp Campaign Template for Approval	POST	/whatsappCampaigns/template/approval/{{templateId}}	conn_mod_def::GJ09SECP6Pc::wAmPL-gwRSe74D9g5aG3Cg
Update a WhatsApp Campaign	PUT	/whatsappCampaigns/{{campaignId}}	conn_mod_def::GJ09SXTSS7g::6eR2pd8aQ8qxD6NUZlZ32w

SmtpTemplates

Action	Method	Path	Action id
Get an SMTP Template's Information	GET	/smtp/templates/{{templateId}}	conn_mod_def::GJ09a7N_GOA::6V6IXekaSPWGVc4MO5dQvw
Create an Email Template	POST	/smtp/templates	conn_mod_def::GJ09XkLHFUA::iFPyaXuSSFiaZTwi7zmGHA
Delete an Inactive Email Template	DELETE	/smtp/templates/{{templateId}}	conn_mod_def::GJ09XrCqrtk::eFUEfdB0RMCID9cwZ6mDpw
Generate a Rendered Preview of a Transactional Template	POST	/smtp/template/preview	conn_mod_def::GJ09YZaafXw::5goMAg5OT0-cpnN7k_BiyA
Send a Template to Your Test List	POST	/smtp/templates/{{templateId}}/sendTest	conn_mod_def::GJ09bC2jGjE::v5QEWPDVQOq7k1aydObubg
Update an Email Template	PUT	/smtp/templates/{{templateId}}	conn_mod_def::GJ09b-jOd8I::uwY2dAcDSjW8_keuYZaY1Q

ContactLists

Action	Method	Path	Action id
Get a Contact List’s Details	GET	/contacts/lists/{{listId}}	conn_mod_def::GJ09B3NIlN0::tmG9rNIQQGi0u9ZAtnqwTg
List Contact Lists	GET	/contacts/lists	conn_mod_def::GJ09CSnijaw::3D0uILP6RfqjtrNQXMaP_Q
Create a Contact List	POST	/contacts/lists	conn_mod_def::GJ09AcuOzXI::BiIupRMKRwyugPLnUq9BwA
Delete a Contact List	DELETE	/contacts/lists/{{listId}}	conn_mod_def::GJ09BM1L-ck::i2fYsr7aTQWGSbvhyiio9A
Update a Contact List	PUT	/contacts/lists/{{listId}}	conn_mod_def::GJ09DioM6xY::JZcNJPPwSX6NjyIrGxJYKw

ContactAttributes

Action	Method	Path	Action id
List All Contact Attributes	GET	/contacts/attributes	conn_mod_def::GJ09DCuW1cE::4TRSa7nHTPuawXZ7lYGxIw
Create a Contact Attribute	POST	/contacts/attributes/{{attributeCategory}}/{{attributeName}}	conn_mod_def::GJ09Aj2k4qs::2K766ZSvRW2499EyLfWwxQ
Delete a Contact Attribute	DELETE	/contacts/attributes/{{attributeCategory}}/{{attributeName}}	conn_mod_def::GJ09BePJ2vQ::Il8aiWcAT3mxW8qaWNaWig
Delete a Multiple-Choice Attribute Option	DELETE	/contacts/attributes/{{attributeType}}/{{multipleChoiceAttribute}}/{{multipleChoiceAttributeOption}}	conn_mod_def::GJ09BXp4EkE::nPoQJQysQZ2nUr7Xqb95wQ
Update a Contact Attribute	PUT	/contacts/attributes/{{attributeCategory}}/{{attributeName}}	conn_mod_def::GJ09Dr-_xoU::bTr3K_fWSBSqumrIil6dkQ

LoyaltyBalanceDefinitions

Action	Method	Path	Action id
Get a Loyalty Program Balance Definition	GET	/loyalty/balance/programs/{{loyaltyProgramId}}/balance-definitions/{{balanceDefinitionId}}	conn_mod_def::GJ09LOouZ5k::JPR7KvNuRZi8r8W_29Rd_w
List a Loyalty Program’s Balance Definitions	GET	/loyalty/balance/programs/{{loyaltyProgramId}}/balance-definitions	conn_mod_def::GJ09LW04ygk::31P3C4rARCe6rLak5YSYeA
Create a Loyalty Program Balance Definition	POST	/loyalty/balance/programs/{{loyaltyProgramId}}/balance-definitions	conn_mod_def::GJ09I3ZYsvA::S-XUVhKARai0Wu_CQbBDPg

2 more LoyaltyBalanceDefinitions actions are available through search.

This lists 90 of 288 actions. For anything not here, call search_one_platform_actions with platform brevo. The full catalog is at https://www.withone.ai/knowledge/brevo.

When a call fails

The error comes from Brevo, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/brevo

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.