How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Brevo Email Campaigns API

The emailCampaigns API from Brevo — 10 operation(s) for emailcampaigns.

Brevo Email Campaigns API is one of 53 APIs that Brevo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Email Campaigns. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 13 operations across 10 paths, and defines 84 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.brevo.com/v3.

13 operations 10 paths 84 schemas 1 DELETE4 GET6 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.brevo.com/v3
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Brevo Email Campaigns API declares 1 security scheme for authenticating requests. An API key is passed in the header as api-key (api-key).

  • api-key — The API key should be passed in the request headers as api-key for authentication.

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 1 DELETE, 4 GET, 6 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

emailCampaigns 13
GET
/emailCampaigns
Return all your created email campaigns
getEmailCampaigns 11 params → 200400
POST
/emailCampaigns
Create an email campaign
createEmailCampaign 1 param body → 201400405
PUT
/emailCampaigns/{campaignId}
Update an email campaign
updateEmailCampaign 2 params body → 204400404405
DELETE
/emailCampaigns/{campaignId}
Delete an email campaign
deleteEmailCampaign 2 params → 204400403404
GET
/emailCampaigns/{campaignId}
Get an email campaign report
getEmailCampaign 4 params → 200400404
POST
/emailCampaigns/{campaignId}/sendNow
Send an email campaign immediately, based on campaignId
sendEmailCampaignNow 2 params → 204400402404
POST
/emailCampaigns/{campaignId}/sendTest
Send an email campaign to your test list
sendTestEmail 2 params body → 204400404
PUT
/emailCampaigns/{campaignId}/status
Update an email campaign status
updateCampaignStatus 2 params body → 204400404
GET
/emailCampaigns/{campaignId}/sharedUrl
Get a shared template url
getSharedTemplateUrl 2 params → 200400404405
POST
/emailCampaigns/{campaignId}/exportRecipients
Export the recipients of an email campaign
emailExportRecipients 2 params body → 202400404
POST
/emailCampaigns/{campaignId}/sendReport
Send the report of a campaign
sendReport 2 params body → 204400404
GET
/emailCampaigns/{campaignId}/abTestCampaignResult
Get an A/B test email campaign results
getAbTestCampaignResult 2 params → 200400404
POST
/emailCampaigns/images
Upload an image to your account's image gallery
uploadImageToGallery 1 param body → 201400

Schemas 84

The contract defines 84 schemas that model the data the API accepts and returns. The most detailed are Email_Campaigns_getEmailCampaign_Response_200 (42 properties), EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItems (42 properties), getCampaignStats (18 properties), Email_Campaigns_getAbTestCampaignResult_Response_200 (8 properties). Each schema is shown below with its type and property counts.

EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItemsEmailExpirationDateUnit
string
Unit of the duration
EmailCampaignsPostResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
Email_Campaigns_getSharedTemplateUrl_Response_200
object
1 property 1 required
EmailExportRecipientsRequestBadRequestError
object
2 properties 2 required
EmailCampaignsCampaignIdExportRecipientsPostResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsCampaignIdPutRequestBodyContentApplicationJsonSchemaEmailExpirationDate
object
To reduce your carbon footprint, set an expiration date for your email. If supported, it will be automatically deleted from the recipient’s inbox, saving stora…
2 properties
EmailCampaignsCampaignIdSendReportPostResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsCampaignIdAbTestCampaignResultGetResponsesContentApplicationJsonSchemaWinningVersion
string
Winning Campaign Info. pending = Campaign has been picked for sending and winning version is yet to be decided, tie = A tie happened between both the versions,…
GetAbTestCampaignResultRequestBadRequestError
object
2 properties 2 required
EmailCampaignsGetParametersSort
string
EmailCampaignsCampaignIdDeleteResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
UpdateCampaignStatusRequestBadRequestError
object
2 properties 2 required
Email_Campaigns_getAbTestCampaignResult_Response_200
object
8 properties
AbTestVersionClicksItems
object
3 properties 3 required
EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItemsType
string
Type of campaign
Email_Campaigns_getEmailCampaign_Response_200
object
42 properties 14 required
updateCampaignStatus
object
Status of the campaign
1 property
GetSharedTemplateUrlRequestBadRequestError
object
2 properties 2 required
EmailCampaignsPostRequestBodyContentApplicationJsonSchemaRecipients
object
Segment ids and List ids to include/exclude from campaign
4 properties
EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItemsStatus
string
Status of the campaign
EmailCampaignsCampaignIdStatusPutResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsCampaignIdGetResponsesContentApplicationJsonSchemaEmailExpirationDate
object
Expiration date configuration for the email campaign, if set. Contains the duration and unit of the email expiry.
2 properties
EmailCampaignsCampaignIdPutRequestBodyContentApplicationJsonSchemaRecipients
object
Segment ids and List ids to include/exclude from campaign
4 properties
EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItemsSender
object
3 properties
Email_Campaigns_emailExportRecipients_Response_202
object
1 property 1 required
EmailCampaignsCampaignIdAbTestCampaignResultGetResponsesContentApplicationJsonSchemaClickedLinks
object
2 properties 2 required
EmailCampaignsCampaignIdGetResponsesContentApplicationJsonSchemaEmailExpirationDateUnit
string
Unit of the duration
EmailCampaignsCampaignIdAbTestCampaignResultGetResponsesContentApplicationJsonSchemaStatistics
object
6 properties 6 required
EmailCampaignsCampaignIdGetParametersStatistics
string
EmailCampaignsCampaignIdPutRequestBodyContentApplicationJsonSchemaEmailExpirationDateUnit
string
unit of the duration
UpdateCampaignStatusRequestNotFoundError
object
2 properties 2 required
EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItemsEmailExpirationDate
object
Expiration date configuration for the email campaign, if set. Contains the duration and unit of the email expiry.
2 properties
getCampaignRecipients
object
4 properties 2 required
errorModel
object
2 properties 1 required
EmailCampaignsPostRequestBodyContentApplicationJsonSchemaEmailExpirationDate
object
To reduce your carbon footprint, set an expiration date for your email. If supported, it will be automatically deleted from the recipient’s inbox, saving stora…
2 properties
EmailCampaignsCampaignIdGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsCampaignIdAbTestCampaignResultGetResponsesContentApplicationJsonSchemaWinningCriteria
string
Criteria chosen for winning version (Open/Click)
GetEmailCampaignRequestNotFoundError
object
2 properties 2 required
UpdateEmailCampaignRequestNotFoundError
object
2 properties 2 required
postSendFailed
object
5 properties 2 required
SendReportEmail
object
Custom attributes for the report email.
2 properties 2 required
sendReport
object
2 properties 1 required
EmailCampaignsCampaignIdSendNowPostResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
SendReportRequestBadRequestError
object
2 properties 2 required
Email_Campaigns_createEmailCampaign_Response_201
object
1 property 1 required
EmailCampaignsCampaignIdPutResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsCampaignIdExportRecipientsPostRequestBodyContentApplicationJsonSchemaRecipientsType
string
Type of recipients to export for a campaign
getCampaignStats
object
18 properties 13 required
EmailCampaignsCampaignIdGetResponsesContentApplicationJsonSchemaSender
object
3 properties
CreateEmailCampaignRequestBadRequestError
object
2 properties 2 required
EmailCampaignsCampaignIdGetResponsesContentApplicationJsonSchemaStatus
string
Status of the campaign
EmailCampaignsCampaignIdGetResponsesContentApplicationJsonSchemaType
string
Type of campaign
DeleteEmailCampaignRequestBadRequestError
object
2 properties 2 required
EmailExportRecipientsRequestNotFoundError
object
2 properties 2 required
EmailCampaignsPostRequestBodyContentApplicationJsonSchemaEmailExpirationDateUnit
string
unit of the duration
SendReportLanguage
string
Language of email content for campaign report sending.
Email_Campaigns_getEmailCampaigns_Response_200
object
2 properties
getDeviceBrowserStats
object
4 properties 4 required
abTestVersionClicks
array
Information on clicked links for a particular version
EmailCampaignsCampaignIdPutRequestBodyContentApplicationJsonSchemaWinnerCriteria
string
Choose the metrics that will determinate the winning version. Mandatory if splitRule = 1 and < 50. If splitRule = 50, winnerCriteria is ignored if passed
EmailCampaignsPostRequestBodyContentApplicationJsonSchemaSender
object
Sender details including id or email and name (optional). Only one of either Sender’s email or Sender’s ID shall be passed in one request at a time. Passing bo…
3 properties
SendEmailCampaignNowRequestNotFoundError
object
2 properties 2 required
EmailCampaignsImagesPostResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
abTestVersionStats
object
Percentage of a particular event for both versions
2 properties 2 required
EmailCampaignsCampaignIdSharedUrlGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsGetParametersStatus
string
Email_Campaigns_uploadImageToGallery_Response_201
object
1 property
GetEmailCampaignsRequestBadRequestError
object
2 properties 2 required
UploadImageToGalleryRequestBadRequestError
object
2 properties 2 required
EmailCampaignsPostRequestBodyContentApplicationJsonSchemaWinnerCriteria
string
Choose the metrics that will determinate the winning version. Mandatory if splitRule = 1 and < 50. If splitRule = 50, winnerCriteria is ignored if passed
getExtendedCampaignStats
object
8 properties 5 required
EmailCampaignsCampaignIdPutRequestBodyContentApplicationJsonSchemaSender
object
Sender details including id or email and name (optional). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For exampl…
3 properties
EmailCampaignsGetParametersType
string
EmailCampaignsGetResponsesContentApplicationJsonSchemaCampaignsItems
object
42 properties 14 required
sendTestEmail
object
1 property
UpdateCampaignStatusStatus
string
Note:- replicateTemplate status will be available only for template type campaigns.
UpdateEmailCampaignRequestBadRequestError
object
2 properties 2 required
SendReportRequestNotFoundError
object
2 properties 2 required
GetExtendedCampaignStatsStatsByDevice
object
4 properties
DeleteEmailCampaignRequestNotFoundError
object
2 properties 2 required
EmailCampaignsCampaignIdAbTestCampaignResultGetResponsesContentApplicationJsonSchemaCode
string
Error code displayed in case of a failure
EmailCampaignsGetParametersStatistics
string
GetEmailCampaignRequestBadRequestError
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

brevo-emailcampaigns-api-openapi.yml Raw ↑

Other APIs Brevo publishes across the network.

brevo Agent Status API
brevo Automated Messages API
brevo Campaign Statistics API
brevo Categories API
brevo Contact Attributes API
brevo Contact Lists API
brevo Contacts API
brevo Email Activity API
brevo Email Campaigns API
brevo Email Templates API
brevo Folders API
brevo Import API
Where this information came from

This is an independent, third-party profile of Brevo Email Campaigns API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.