Brevo API
OpenAPI 3.1 coverage for Brevo contacts, lists, email campaigns and transactional email endpoints.
Connect this API to an AI agent Browse all specs
What you can do with Brevo API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /contacts |
getContacts | List contacts Method: GET Path: /contacts IMPORTANT: This function has 0 REQUIRED parameter(s) and 4 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - limit: limit parameter. - offset: offset parameter. - sort: sort parameter. - sortBy: sortBy parameter. |
| POST | /contacts |
postContacts | Create a contact Method: POST Path: /contacts IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /contacts/{identifier} |
getContactsByIdentifier | Get contact details Method: GET Path: /contacts/{identifier} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - identifier: identifier parameter. |
| PUT | /contacts/{identifier} |
putContactsByIdentifier | Update a contact Method: PUT Path: /contacts/{identifier} IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - identifier: identifier parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| POST | /contacts/import |
postContactsImport | Import contacts Method: POST Path: /contacts/import IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /contacts/lists |
getContactsLists | List contact lists Method: GET Path: /contacts/lists IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - limit: limit parameter. - offset: offset parameter. |
| GET | /contacts/lists/{listId}/contacts |
getContactsListsByListidContacts | List contacts in a list Method: GET Path: /contacts/lists/{listId}/contacts IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - listId: listId parameter. Query Parameters: OPTIONAL: - limit: limit parameter. - offset: offset parameter. |
| GET | /emailCampaigns |
getEmailcampaigns | List email campaigns Method: GET Path: /emailCampaigns IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - limit: limit parameter. - offset: offset parameter. - sort: sort parameter. |
| POST | /emailCampaigns |
postEmailcampaigns | Create an email campaign Method: POST Path: /emailCampaigns IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /emailCampaigns/{campaignId} |
getEmailcampaignsByCampaignid | Get an email campaign Method: GET Path: /emailCampaigns/{campaignId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - campaignId: campaignId parameter. |
| POST | /smtp/email |
postSmtpEmail | Send a transactional email Method: POST Path: /smtp/email IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
Usage guide
## Brevo API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create an API key in Brevo under SMTP & API. Send it in the `api-key` header. Keep the key server-side and use the documented v3 routes and rate limits. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Brevo API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.