/couponCollections/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Id of the collection to update |
Values to update the coupon collection
application/json
CouponsUpdateCouponCollectionByIdRequest
| Property | Type | Required |
|---|---|---|
| defaultCoupon | string | optional |
| expirationDate | string | optional |
| remainingDaysAlert | integer | optional |
| remainingCouponsAlert | integer | optional |
Coupon collection updated
bad request
unauthorized
PATCH /couponCollections/{id}
/coupons
Values to create coupons
application/json
CouponsCreateCouponCollectionRequest
| Property | Type | Required |
|---|---|---|
| coupons | array | required |
| collectionId | string | required |
Coupons creation in progress
bad request
unauthorized
Coupon collection not found
POST /coupons
/crm/attributes/deals
Returns list of deal attributes
GET /crm/attributes/deals
/crm/deals
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| filters[attributes.deal_name] | query | optional | string | Filter by attributes. If you have a filter for the owner on your end, please send it as filters[attributes.deal_owner] and utilize the account email for the filtering. |
| filters[linkedCompaniesIds] | query | optional | string | Filter by linked companies ids |
| filters[linkedContactsIds] | query | optional | string | Filter by linked companies ids |
| offset | query | optional | integer | Index of the first document of the page |
| limit | query | optional | integer | Number of documents per page |
| sort | query | optional | string | Sort the results in the ascending/descending order. Default order is descending by creation if |
Returns deals list with filters
Returned when query params are invalid
GET /crm/deals
/crm/deals
Deal create data.
application/json
DealsCreateNewDealRequest
| Property | Type | Required |
|---|---|---|
| name | string | required |
| attributes | object | optional |
Created new Deal
Returned when invalid data posted
POST /crm/deals
/crm/deals/link-unlink/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
Linked / Unlinked contacts and companies ids.
application/json
DealsLinkUnlinkPatchRequest
| Property | Type | Required |
|---|---|---|
| linkCompanyIds | array | optional |
| linkContactIds | array | optional |
| unlinkCompanyIds | array | optional |
| unlinkContactIds | array | optional |
Successfully linked/unlinked contacts/companies with the deal.
Returned when query params are invalid or invalid data provided in request.
PATCH /crm/deals/link-unlink/{id}
/crm/deals/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
Returned when item deleted
Returned when invalid data posted
Returned when deal id is not found
DELETE /crm/deals/{id}
/crm/deals/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
Returns the deal by id
Returned when task id is invalid
Returned when item not found
GET /crm/deals/{id}
/crm/deals/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
Updated deal details.
application/json
DealsUpdateDealByIdRequest
| Property | Type | Required |
|---|---|---|
| name | string | optional |
| attributes | object | optional |
Deal updated successfully
Returned when invalid data posted
Returned when deal id is not found
PATCH /crm/deals/{id}
/crm/pipeline/details/all
Returns list of pipeline and its details
Returned when pipeline id is invalid or does not exist
GET /crm/pipeline/details/all
/crm/pipeline/details/{pipelineID}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pipelineID | path | required | string | — |
Returns pipeline and its details
Returned when pipeline id is invalid or does not exist
GET /crm/pipeline/details/{pipelineID}
/senders/domains
list of domains
bad request
GET /senders/domains
/senders/domains
domain’s name
application/json
createDomain
| Property | Type | Required |
|---|---|---|
| name | string | required |
domain created
bad request
POST /senders/domains
/senders/domains/{domainName}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| domainName | path | required | string | Domain name |
domain deleted
bad request
Domain does not exist
DELETE /senders/domains/{domainName}
/senders/domains/{domainName}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| domainName | path | required | string | Domain name |
domain configuration
bad request
Domain does not exist
GET /senders/domains/{domainName}
/senders/domains/{domainName}/authenticate
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| domainName | path | required | string | Domain name |
domain authenticated
bad request
Domain does not exist
PUT /senders/domains/{domainName}/authenticate
/categories
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| limit | query | optional | integer | Number of documents per page |
| offset | query | optional | integer | Index of the first document in the page |
| sort | query | optional | string | Sort the results in the ascending/descending order of record creation. Default order is descending if |
| ids | query | optional | array | Filter by category ids |
| name | query | optional | string | Filter by category name |
| modifiedSince | query | optional | string | Filter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. |
| createdSince | query | optional | string | Filter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. |
All categories listed
bad request
GET /categories
/categories
Values to create/update a category
application/json
createUpdateCategory
| Property | Type | Required |
|---|---|---|
| id | string | required |
| url | string | optional |
| name | string | optional |
| deletedAt | string | optional |
| updateEnabled | boolean | optional |
Category created
Category updated
bad request
POST /categories
/categories/batch
Values to create a batch of categories
application/json
createUpdateBatchCategory
| Property | Type | Required |
|---|---|---|
| categories | array | required |
| └ id | string | required |
| └ url | string | optional |
| └ name | string | optional |
| └ deletedAt | string | optional |
| updateEnabled | boolean | optional |
Category created and updated
bad request
POST /categories/batch
/categories/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Category ID |
Category informations
bad request
Category id not found
GET /categories/{id}
/ecommerce/activate
Getting access to Brevo eCommerce.
eCommerce activation is in process, please wait for 5 minutes.
unauthorized
api-key not found
POST /ecommerce/activate
/ecommerce/attribution/metrics
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| periodFrom | query | optional | string | When getting metrics for a specific period, define the starting datetime in RFC3339 format |
| periodTo | query | optional | string | When getting metrics for a specific period, define the end datetime in RFC3339 format |
| emailCampaignId[] | query | optional | array | The email campaign id(s) to get metrics for |
OK
bad request
GET /ecommerce/attribution/metrics
/ecommerce/attribution/metrics/{conversionSource}/{conversionSourceId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversionSource | path | required | string | The Brevo campaign type for which data will be retrieved |
| conversionSourceId | path | required | number | The Brevo campaign id for which data will be retrieved |
OK
bad request
GET /ecommerce/attribution/metrics/{conversionSource}/{conversionSourceId}
/ecommerce/attribution/products/{conversionSource}/{conversionSourceId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversionSource | path | required | string | The Brevo campaign type for which data will be retrieved |
| conversionSourceId | path | required | number | The Brevo campaign id for which data will be retrieved |
OK
bad request
GET /ecommerce/attribution/products/{conversionSource}/{conversionSourceId}
/orders
Get all the orders
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| limit | query | optional | integer | Number of documents per page |
| offset | query | optional | integer | Index of the first document in the page |
| sort | query | optional | string | Sort the results in the ascending/descending order of record creation. Default order is descending if |
| modifiedSince | query | optional | string | Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. |
| createdSince | query | optional | string | Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. |
orders fetched successfully
bad request
GET /orders
/orders/status
Manages the transactional status of the order
application/json
order
| Property | Type | Required |
|---|---|---|
| id | string | required |
| string | optional | |
| amount | number | required |
| status | string | required |
| billing | object | optional |
| └ city | string | optional |
| └ phone | string | optional |
| └ region | string | optional |
| └ address | string | optional |
| └ postCode | string | optional |
| └ countryCode | string | optional |
| └ paymentMethod | string | optional |
| coupons | array | optional |
| products | array | required |
| └ price | number | required |
| └ quantity | number | required |
| └ productId | string | required |
| └ variantId | string | optional |
| createdAt | string | required |
| updatedAt | string | required |
Order Event posted
bad request
POST /orders/status
/orders/status/batch
Create multiple orders at one time instead of one order at a time
application/json
orderBatch
| Property | Type | Required |
|---|---|---|
| orders | array | required |
| └ id | string | required |
| string | optional | |
| └ amount | number | required |
| └ status | string | required |
| └ billing | object | optional |
| └ city | string | optional |
| └ phone | string | optional |
| └ region | string | optional |
| └ address | string | optional |
| └ postCode | string | optional |
| └ countryCode | string | optional |
| └ paymentMethod | string | optional |
| └ coupons | array | optional |
| └ products | array | required |
| └ price | number | required |
| └ quantity | number | required |
| └ productId | string | required |
| └ variantId | string | optional |
| └ createdAt | string | required |
| └ updatedAt | string | required |
| notifyUrl | string | optional |
| historical | boolean | optional |
bad request
POST /orders/status/batch
/products
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| limit | query | optional | integer | Number of documents per page |
| offset | query | optional | integer | Index of the first document in the page |
| sort | query | optional | string | Sort the results in the ascending/descending order of record creation. Default order is descending if |
| ids | query | optional | array | Filter by product ids |
| name | query | optional | string | Filter by product name, minimum 3 characters should be present for search |
| price[lte] | query | optional | number | Price filter for products less than and equals to particular amount |
| price[gte] | query | optional | number | Price filter for products greater than and equals to particular amount |
| price[lt] | query | optional | number | Price filter for products less than particular amount |
| price[gt] | query | optional | number | Price filter for products greater than particular amount |
| price[eq] | query | optional | number | Price filter for products equals to particular amount |
| price[ne] | query | optional | number | Price filter for products not equals to particular amount |
| categories | query | optional | array | Filter by product categories |
| modifiedSince | query | optional | string | Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. |
| createdSince | query | optional | string | Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. |
All products listed
bad request
GET /products
/products
Values to create/update a product
application/json
createUpdateProduct
| Property | Type | Required |
|---|---|---|
| id | string | required |
| sku | string | optional |
| url | string | optional |
| name | string | required |
| price | number | optional |
| imageUrl | string | optional |
| metaInfo | object | optional |
| parentId | string | optional |
| deletedAt | string | optional |
| categories | array | optional |
| updateEnabled | boolean | optional |
Product created
Product updated
bad request
POST /products
/products/batch
Values to create a batch of products
application/json
createUpdateBatchProducts
| Property | Type | Required |
|---|---|---|
| products | array | required |
| └ id | string | required |
| └ sku | string | optional |
| └ url | string | optional |
| └ name | string | required |
| └ price | number | optional |
| └ imageUrl | string | optional |
| └ metaInfo | object | optional |
| └ parentId | string | optional |
| └ deletedAt | string | optional |
| └ categories | array | optional |
| updateEnabled | boolean | optional |
Products created and updated
bad request
POST /products/batch
/products/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Product ID |
Product informations
bad request
Product’s id not found
GET /products/{id}
/emailCampaigns
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| type | query | optional | string | Filter on the type of the campaigns |
| status | query | optional | string | Filter on the status of the campaign |
| statistics | query | optional | string | Filter on the type of statistics required. Example globalStats value will only fetch globalStats info of the campaign in returned response. |
| startDate | query | optional | string | Mandatory if endDate is used. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent email campaigns. |
| endDate | query | optional | string | Mandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent email campaigns. |
| limit | query | optional | integer | Number of documents per page |
| offset | query | optional | integer | Index of the first document in the page |
| sort | query | optional | string | Sort the results in the ascending/descending order of record creation. Default order is descending if |
| excludeHtmlContent | query | optional | boolean | Use this flag to exclude htmlContent from the response body. If set to true, htmlContent field will be returned as empty string in the response body |
Email campaigns informations
bad request
GET /emailCampaigns
/emailCampaigns
Values to create a campaign
application/json
createEmailCampaign
| Property | Type | Required |
|---|---|---|
| tag | string | optional |
| name | string | required |
| footer | string | optional |
| header | string | optional |
| params | object | optional |
| sender | object | required |
| └ id | integer | optional |
| └ name | string | optional |
| string | optional | |
| htmlUrl | string | optional |
| replyTo | string | optional |
| subject | string | optional |
| toField | string | optional |
| subjectA | string | optional |
| subjectB | string | optional |
| abTesting | boolean | optional |
| splitRule | integer | optional |
| recipients | object | optional |
| └ listIds | array | optional |
| └ segmentIds | array | optional |
| └ exclusionListIds | array | optional |
| templateId | integer | optional |
| htmlContent | string | optional |
| previewText | string | optional |
| scheduledAt | string | optional |
| utmCampaign | string | optional |
| …11 more | object | optional |
bad request
POST /emailCampaigns
/emailCampaigns/images
Parameters to upload an image
application/json
uploadImageToGallery
| Property | Type | Required |
|---|---|---|
| name | string | optional |
| imageUrl | string | required |
Image has been successfully uploaded
bad request
POST /emailCampaigns/images
/emailCampaigns/{campaignId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | id of the campaign |
Email campaign has been deleted
bad request
Campaign ID not found
DELETE /emailCampaigns/{campaignId}
/emailCampaigns/{campaignId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
| statistics | query | optional | string | Filter on the type of statistics required. Example globalStats value will only fetch globalStats info of the campaign in returned response. |
Email campaign informations
bad request
Campaign ID not found
GET /emailCampaigns/{campaignId}
/emailCampaigns/{campaignId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
Values to update a campaign
application/json
updateEmailCampaign
| Property | Type | Required |
|---|---|---|
| tag | string | optional |
| name | string | optional |
| footer | string | optional |
| header | string | optional |
| params | object | optional |
| sender | object | optional |
| └ id | integer | optional |
| └ name | string | optional |
| string | optional | |
| htmlUrl | string | optional |
| replyTo | string | optional |
| subject | string | optional |
| toField | string | optional |
| subjectA | string | optional |
| subjectB | string | optional |
| abTesting | boolean | optional |
| recurring | boolean | optional |
| splitRule | integer | optional |
| recipients | object | optional |
| └ listIds | array | optional |
| └ segmentIds | array | optional |
| └ exclusionListIds | array | optional |
| htmlContent | string | optional |
| previewText | string | optional |
| scheduledAt | string | optional |
| utmCampaign | string | optional |
| …11 more | object | optional |
Email campaign updated
bad request
Campaign ID not found
PUT /emailCampaigns/{campaignId}
/emailCampaigns/{campaignId}/abTestCampaignResult
Obtain winning version of an A/B test email campaign
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the A/B test campaign |
A/B test email campaign Result
bad request
A/B test Email Campaign not found
GET /emailCampaigns/{campaignId}/abTestCampaignResult
/emailCampaigns/{campaignId}/exportRecipients
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
Values to send for a recipient export request
application/json
emailExportRecipients
| Property | Type | Required |
|---|---|---|
| notifyURL | string | optional |
| recipientsType | string | required |
bad request
Campaign ID not found
POST /emailCampaigns/{campaignId}/exportRecipients
/emailCampaigns/{campaignId}/sendNow
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
Email campaign has been scheduled
Campaign could not be sent
You don’t have enough credit to send your campaign. Please update your plan
Campaign ID not found
POST /emailCampaigns/{campaignId}/sendNow
/emailCampaigns/{campaignId}/sendReport
A PDF will be sent to the specified email addresses
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
Values for send a report
application/json
sendReport
| Property | Type | Required |
|---|---|---|
| object | required | |
| └ to | array | required |
| └ body | string | required |
| language | string | optional |
Report has been successfully sent to the defined recipients
bad request
Campaign ID not found
POST /emailCampaigns/{campaignId}/sendReport
/emailCampaigns/{campaignId}/sendTest
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
application/json
sendTestEmail
| Property | Type | Required |
|---|---|---|
| emailTo | array | optional |
Test email has been sent successfully to all recipients
Test email could not be sent to the following email addresses
Campaign ID not found
POST /emailCampaigns/{campaignId}/sendTest
/emailCampaigns/{campaignId}/sharedUrl
Get a unique URL to share & import an email template from one Brevo account to another.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign or template |
Shared template URL information
bad request
Campaign/Template ID not found
Only email campaigns or templates are allowed
GET /emailCampaigns/{campaignId}/sharedUrl
/emailCampaigns/{campaignId}/status
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| campaignId | path | required | integer | Id of the campaign |
Status of the campaign
application/json
updateCampaignStatus
| Property | Type | Required |
|---|---|---|
| status | string | optional |
The campaign status has been updated successfully
bad request
Campaign ID not found
PUT /emailCampaigns/{campaignId}/status
/events
Create an event to track a contact’s interaction.
application/json
event
| Property | Type | Required |
|---|---|---|
| event_date | string | optional |
| event_name | string | required |
| identifiers | object | required |
| └ sms | string | optional |
| └ ext_id | string | optional |
| └ email_id | string | optional |
| string | optional | |
| └ landline_number | string | optional |
| event_properties | object | optional |
| contact_properties | object | optional |
An event posted
bad request
unauthorized
POST /events
/feeds
This endpoint can fetch all created external feeds.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| search | query | optional | string | Can be used to filter records by search keyword on feed name |
| startDate | query | optional | string | Mandatory if |
| endDate | query | optional | string | Mandatory if |
| sort | query | optional | string | Sort the results in the ascending/descending order of record creation. Default order is descending if |
| authType | query | optional | string | Filter the records by |
| limit | query | optional | integer | Number of documents returned per page. |
| offset | query | optional | integer | Index of the first document on the page. |
External feeds
Invalid parameters passed
Record not found
GET /feeds
/feeds
This endpoint will create an external feed.
Values to create a feed
application/json
createExternalFeed
| Property | Type | Required |
|---|---|---|
| url | string | required |
| name | string | required |
| cache | boolean | optional |
| token | string | optional |
| headers | array | optional |
| └ name | string | optional |
| └ value | string | optional |
| authType | string | optional |
| password | string | optional |
| username | string | optional |
| maxRetries | integer | optional |
successfully created
bad request
POST /feeds
/feeds/{uuid}
This endpoint will delete an external feed.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| uuid | path | required | string | UUID of the feed to delete |
Feed deleted
bad request
Feed not found
DELETE /feeds/{uuid}
/feeds/{uuid}
This endpoint will update an external feed.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| uuid | path | required | string | UUID of the feed to fetch |
External feed
bad request
Feed not found
GET /feeds/{uuid}
/feeds/{uuid}
This endpoint will update an external feed.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| uuid | path | required | string | UUID of the feed to update |
Values to update a feed
application/json
updateExternalFeed
| Property | Type | Required |
|---|---|---|
| url | string | optional |
| name | string | optional |
| cache | boolean | optional |
| token | string | optional |
| headers | array | optional |
| └ name | string | optional |
| └ value | string | optional |
| authType | string | optional |
| password | string | optional |
| username | string | optional |
| maxRetries | integer | optional |
Feed updated
bad request
Feed not found
PUT /feeds/{uuid}