Here you will find the list of all the transactional events you can track. Please consider the request schema and parameters for each of them when you decide to build the Notify URL on your side.
📘 Datetime parameters 🕗
The following parameters are present in most of the events we offer tracking for. Keep this information in mind whenever working with webhook datetime values.
ts_epoch
, ts_event
: UTC Timezone
date
: CET/CEST Timezone
Attribute name Data type Description event
string "request" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message ts_epoch
integer time stamp in milliseconds UTC of when message was sent template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message mirror_link
string A preview link corresponding to the UI logs for the event contact_id
integer Brevo identifier for an existing contact. If contact is not present , return 0
JSON
{
"event":"request",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"ts_epoch": 1604933654,
"template_id": 22,
"mirror_link": "https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"contact_id": 8,
"tags": ["transac_messages"]
}
Attribute name Data type Description event
string "click" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message ts_epoch
integer time stamp in milliseconds UTC of when message was sent template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message link
string URL accessed by recipient user_agent
string Information about the user’s browser or email client device_used
string Details about the device from which the action originated contact_id
integer Brevo identifier for an existing contact. If contact is not present , return 0 mirror_link
string A preview link corresponding to the UI logs for the event
JSON
{
"event":"click",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"ts_epoch": 1604933654,
"template_id": 22,
"tags": ["transac_messages"],
"user_agent": "Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)",
"device_used": "DESKTOP",
"mirror_link": "https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"contact_id": 8,
"link": "https://domain.com/product"
}
Attribute name Data type Description event
string "deferred" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message ts_epoch
integer time stamp in milliseconds UTC of when message was sent template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message reason
string the reason the message has been deferred
JSON
{
"event":"deferred",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"ts_epoch": 1604933654,
"template_id": 22,
"tags": ["transac_messages"],
"reason": "spam"
}
Attribute name Data type Description event
string "delivered" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred ts_epoch
integer time stamp in milliseconds UTC of when message was sent subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message
JSON
{
"event":"delivered",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"template_id": 22,
"tags": ["transac_messages"],
}
Attribute name Data type Description event
string "soft_bounce" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message reason
string the reason the message has been soft bounced
JSON
{
"event":"soft_bounce",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"template_id": 22,
"tags": ["transac_messages"],
"reason": "server is down"
}
Attribute name Data type Description event
string "hard_bounce" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message reason
string the reason the message has been soft bounced ts_epoch
integer time stamp in milliseconds UTC of when message was sent
JSON
{
"event":"hard_bounce",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"template_id": 22,
"tags": ["transac_messages"],
"reason": "server is down",
"ts_epoch":1604933653
}
Attribute name Data type Description event
string "spam" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred X-Mailin-custom
string custom added header tags
array of strings tags you might have used to identify your message
JSON
{
"event":"spam",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"X-Mailin-custom": "some_custom_header",
"tags": ["transac_messages"],
}
Attribute name Data type Description event
string "unique_opened" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message ts_epoch
integer time stamp in milliseconds UTC of when message was sent user_agent
string Information about the user’s browser or email client device_used
string Details about the device from which the action originated mirror_link
string A preview link corresponding to the UI logs for the event contact_id
integer Brevo identifier for an existing contact. If its not present , return 0
JSON
{
"event":"unique_opened",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"template_id": 22,
"tags": ["transac_messages"],
"user_agent": "Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)",
"device_used": "DESKTOP",
"mirror_link": "https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"contact_id": 8,
"ts_epoch": 1604933623
}
Attribute name Data type Description event
string "opened" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header sending_ip
string ip used to send message template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message ts_epoch
integer time stamp in milliseconds UTC of when message was sent user_agent
string Information about the user’s browser or email client device_used
string Details about the device from which the action originated contact_id
integer Brevo identifier for an existing contact. If its not present , return 0 mirror_link
string A preview link corresponding to the UI logs for the event
JSON
{
"event":"opened",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"sending_ip": "xxx.xxx.xxx.xxx",
"template_id": 22,
"user_agent": "Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)",
"device_used": "DESKTOP",
"mirror_link": "https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"contact_id": 8,
"tags": ["transac_messages"],
"ts_epoch": 1604933623
}
Attribute name Data type Description event
string "invalid_email" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message ts_epoch
integer time stamp in milliseconds UTC of when message was sent
JSON
{
"event":"invalid_email",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"template_id": 22,
"tags": ["transac_messages"],
"ts_epoch": 1604933623
}
Attribute name Data type Description event
string "blocked" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message ts_epoch
integer time stamp in milliseconds UTC of when message was sent
JSON
{
"event":"blocked",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"template_id": 22,
"tags": ["transac_messages"],
"ts_epoch": 1604933623
}
Attribute name Data type Description event
string "error" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header template_id
integer internal id of the template tags
array of strings tags you might have used to identify your message ts_epoch
integer time stamp in milliseconds UTC of when message was sent
JSON
{
"event":"invalid_email",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"template_id": 22,
"tags": ["transac_messages"],
"ts_epoch": 1604933623
}
Attribute name Data type Description event
string "unsubscribed" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone ts
integer timestamp in seconds of when event occurred message-id
string internal message id ts_event
integer time stamp in seconds GMT of when event occurred subject
string message subject X-Mailin-custom
string custom added header template_id
integer internal id of the template tag
string tag you might have used to identify your message ts_epoch
integer time stamp in milliseconds UTC of when message was sent sending_ip
string IP used to send the message user_agent
string Information about the user’s browser or email client device_used
string Details about the device from which the action originated mirror_link
string A preview link corresponding to the UI logs for the event contact_id
integer Brevo identifier for an existing contact. If its not present , return 0
JSON
{
"event":"unsubscribed",
"email": "[email protected] ",
"id": xxxxx,
"date": "2020-10-09 00:00:00",
"ts":1604933619,
"message-id": "[email protected] ",
"ts_event": 1604933654,
"subject": "My first Transactional",
"X-Mailin-custom": "some_custom_header",
"template_id": 22,
"tag":"[\"transactionalTag\"]",
"user_agent": "Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)",
"device_used": "MOBILE",
"mirror_link": "https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"contact_id": 8,
"ts_epoch": 1604933623,
"sending_ip": "xxx.xxx.xxx.xxx"
}
Attribute name Data type Description event
string "proxy_open" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone message-id
string internal message id subject
string message subject tag
string tag you might have used to identify your message sending_ip
string IP used to send the message ts_epoch
integer time stamp in milliseconds UTC of when message was sent ts_event
integer it is the time at which the callback is sent to client in Unix format template_id
integer internal id of the template user_agent
string Information about the user’s browser or email client device_used
string Details about the device from which the action originated mirror_link
string A preview link corresponding to the UI logs for the event contact_id
integer Brevo identifier for an existing contact. If its not present , return 0
JSON
{
"event": "proxy_open",
"email": "[email protected] "
"id": 1,
"date": "2020-10-09 00:00:00",
"message-id": "[email protected] ".
"subject": "My first Transactional",
"tag": "[\"transactionalTag\"]",
"sending_ip": "xxx.xxx.xxx.xxx",
"ts_epoch": 1534486682000,
"user_agent": "Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)",
"device_used": "DESKTOP",
"mirror_link": "https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"contact_id": 8,
"template_id": 1
}
Attribute name Data type Description event
string "unique_proxy_open" email
string recipient of message id
integer webhook id date
string date sent listed in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND in your timezone message-id
string internal message id subject
string message subject tag
string tag you might have used to identify your message sending_ip
string IP used to send the message ts
integer timestamp in seconds of when event occurred ts_epoch
integer time stamp in milliseconds UTC of when message was sent ts_event
integer it is the time at which the callback is sent to client in Unix format template_id
integer internal id of the template link
string URL accessed by recipient mirror_link
string A preview link corresponding to the UI logs for the event tags
array of strings tags you might have used to identify your message user_agent
string Information about the user’s browser or email client device_used
string Details about the device from which the action originated contact_id
integer Brevo identifier for an existing contact. If its not present , return 0 sender_email
string Email of the sender
JSON
{
"id":25290,
"email":"",
"message-id":"an#2705147202202651768",
"date":"2024-08-22 16:03:29",
"tags":[
"this_tag",
"tag_thos"
],
"tag":"[\"this_tag\", \"tag_thos\"]",
"event":"unique_proxy_open",
"subject":"this is required subject",
"sending ip":"::",
"ts":1724322809,
"template_id":660,
"ts_epoch":1724322809710,
"ts_event":1724322809,
"link":"",
"sender_email":"[email protected] ",
"mirror_link":"https://app-smtp.brevo.com/log/preview/1a2000f4-4e33-23aa-ab68-900dxxx9152c",
"user_agent":"Mozilla/5.0",
"device_used":"DESKTOP",
"contact_id":4816445214646337536
}
Attribute name Datatype Description bounce_type
String Type of bounce occurred e.g. hard_bounce, soft_bounce date
String It shows the time in YEAR-MONTH-DAY, HOUR:MINUTE:SECOND at which the callback is sent to client in his timezone. description
String Description of event occurred. It could be accepted, delivered, unsubscribed, replied etc. errorCode
Integer This code tells us the status of the SMS messageId
Integer Id of the Transactional SMS message that is sent msg_status
String Status of the SMS message which could be unsubscribed, replied, soft_bounce etc. reply
String Shows the content of the reply received by the recipient status
String Status of the webhook which will be ok by default tag
String SMS tag if the client has used any to
String Includes the contact number of the recipient ts_event
Integer it is the time at which the callback is sent to client in Unix format reference
String Every sms has an unique encoded string which is reference
JSON
"transactional_webhook": {
"body": {
"bounce_type": "",
"date": "2024-06-09 12:55:34",
"description": "accepted",
"errorCode": 0,
"messageId": 52932335915003,
"msg_status": "accepted",
"reference": {
"1": "hf0hhxatvatm5daofc"
},
"reply": "",
"status": "OK",
"tag": "",
"to": "33623964448",
"ts_event": 1717930521
},
}
📘 Transactional SMS webhook events
sent
accepted
delivered
unsubscribe
reply
softbounce
hardbounce
Attribute name Datatype Description id
Integer Unique id generated for each payload to
String Mobile number of the recipient sms_count
Integer Number of sms parts sent credits_used
Float Credits deducted remaining_credit
Float Remaining balance credit msg_status
String Status of the message(sent, delivered, soft_bounce, hard_bounce) date
String Time at which the event is generated type
String Type of SMS (Marketing/Transactional)
JSON
{
"id": 26570,
"to": "918076721713",
"sms_count": 1,
"credits_used": 1.5,
"remaining_credit": 11488.845,
"msg_status": "sent",
"date": "2024-10-11 14:19:59",
"type": "transactional"
}
Attribute name Datatype Description id
Integer Unique id generated for each payload status
String Status msg_status
String Status of the message(sent, delivered, soft_bounce, hard_bounce) description
String Bounce Reason for failed to deliver message to
String Mobile number of the recipient ts_event
Integer It is the time at which the callback is sent to client in Unix format date
String Time at which the event is generated tag
Array of strings SMS tag if the client has used any type
String Type of SMS (Marketing/Transactional)
JSON
{
"id": 26527,
"status": "OK",
"msg_status": "delivered",
"description": "delivered",
"to": "919102606271",
"ts_event": 1728459617,
"date": "2024-10-09 13:10:17",
"tag": [
"tag1name"
],
"type": "transactional"
}
Attribute name Datatype Description id
Integer Unique id generated for each payload msg_status
String Status of the message(sent, delivered, soft_bounce, hard_bounce) description
String Bounce Reason for Failed to deliver message to
String Mobile number of the recipient ts_event
Integer It is the time at which the callback is sent to client in Unix format date
String Time at which the event is generated tag
Array of strings SMS tag if the client has used any reply
String Reply of SMS error_code
Integer Error code type
String Type of SMS (Marketing/Transactional)
JSON
{
"id": 26519,
"msg_status": "replied",
"error_code": 101,
"description": "replied",
"to": "919368207022",
"reply": "Hi",
"ts_event": 1728386415,
"date": "2024-10-08 16:50:16",
"tag": [
"tag1name","tag2name"
],
"type": "transactional"
}
Attribute name Datatype Description id
Integer Unique id generated for each payload msg_status
String Status of the message(sent, delivered, soft_bounce, hard_bounce) description
String Bounce reason for failed to deliver message to
String Mobile number of the recipient bounce_type
String Hard bounce or soft bounce ts_event
Integer It is the time at which the callback is sent to client in Unix format date
String Time at which the event is generated tag
Array of strings SMS tag if the client has used any error_code
Integer Error code type
String Type of SMS (Marketing/Transactional)
JSON
{
"id": 26519,
"msg_status": "soft_bounce",
"description": "Failed to deliver message for reasons unknown",
"bounce_type": "soft_bounce",
"error_code": 7,
"to": "916778678623",
"ts_event": 1728390422,
"date": "2024-10-08 17:57:03",
"tag": [
"tag1name","tag2name"
],
"type": "transactional"
}
Attribute name Datatype Description id
Integer Unique id generated for each payload msg_status
String Status of the message(sent, delivered, soft_bounce, hard_bounce) description
String Bounce reason for failed to deliver message to
String Mobile number of the recipient ts_event
Integer It is the time at which the callback is sent to client in Unix format date
String Time at which the event is generated tag
Array of strings SMS tag if the client has used any type
String Type of SMS (Marketing/Transactional) messageId
Integer Message Id for Transactional SMS
JSON
{
"id": 26519,
"msg_status": "skip",
"description": "skip",
"to": "12018577757",
"ts_event": 1728390414,
"date": "2024-10-08 17:56:54",
"messageId": 0,
"tag": [
"tag1name","tag2name"
],
"type": "transactional"
}