brevo · AsyncAPI Specification

Brevo Webhook Events

Version 3.0

Brevo delivers real-time event notifications via webhooks for transactional emails, marketing campaigns, transactional SMS, and conversations. When configured, Brevo sends HTTP POST requests to your specified endpoint URL with event payloads describing delivery status changes, recipient interactions, and contact list updates.

View Spec View on GitHub AsyncAPIWebhooksEvents

Channels

/transactional-email-events
publish receiveTransactionalEmailEvent
Receive transactional email event
Transactional email event notifications including delivery status, opens, clicks, bounces, spam reports, and unsubscribes.
/marketing-email-events
publish receiveMarketingEmailEvent
Receive marketing email event
Marketing campaign event notifications including delivery, opens, clicks, bounces, spam reports, unsubscribes, and contact list changes.
/transactional-sms-events
publish receiveTransactionalSmsEvent
Receive transactional SMS event
Transactional SMS event notifications including delivery status, bounces, and subscriber changes.
/inbound-email-events
publish receiveInboundEmailEvent
Receive inbound email processed event
Inbound email processing event notifications when incoming emails are received and processed.
/conversations-events
publish receiveConversationsEvent
Receive conversations event
Conversations event notifications for chat messages and visitor interactions.

Messages

✉
EmailDeliveredEvent
Email Delivered
Fired when a transactional email is successfully delivered to the recipient's mail server.
✉
EmailOpenedEvent
Email Opened
Fired when a recipient opens a transactional email.
✉
EmailClickedEvent
Email Link Clicked
Fired when a recipient clicks a link in a transactional email.
✉
EmailHardBounceEvent
Email Hard Bounce
Fired when a transactional email permanently bounces due to an invalid or non-existent email address.
✉
EmailSoftBounceEvent
Email Soft Bounce
Fired when a transactional email temporarily bounces due to a full mailbox or temporary server issue.
✉
EmailSpamEvent
Email Marked as Spam
Fired when a recipient marks a transactional email as spam.
✉
EmailBlockedEvent
Email Blocked
Fired when a transactional email is blocked from sending.
✉
EmailInvalidEvent
Invalid Email
Fired when a transactional email is sent to an invalid email address.
✉
EmailDeferredEvent
Email Deferred
Fired when delivery of a transactional email is temporarily deferred by the receiving mail server.
✉
EmailUnsubscribedEvent
Email Unsubscribed
Fired when a recipient unsubscribes from transactional emails.
✉
MarketingDeliveredEvent
Marketing Email Delivered
Fired when a marketing campaign email is successfully delivered.
✉
MarketingOpenedEvent
Marketing Email Opened
Fired when a recipient opens a marketing campaign email.
✉
MarketingClickedEvent
Marketing Email Link Clicked
Fired when a recipient clicks a link in a marketing campaign email.
✉
MarketingHardBounceEvent
Marketing Email Hard Bounce
Fired when a marketing campaign email permanently bounces.
✉
MarketingSoftBounceEvent
Marketing Email Soft Bounce
Fired when a marketing campaign email temporarily bounces.
✉
MarketingSpamEvent
Marketing Email Marked as Spam
Fired when a recipient marks a marketing campaign email as spam.
✉
MarketingUnsubscribedEvent
Marketing Email Unsubscribed
Fired when a recipient unsubscribes from marketing emails.
✉
MarketingListAdditionEvent
Contact Added to List
Fired when a contact is added to a marketing list.
✉
ContactDeletedEvent
Contact Deleted
Fired when a contact is deleted from the account.
✉
ContactUpdatedEvent
Contact Updated
Fired when a contact's attributes are updated.
✉
SmsSentEvent
SMS Sent
Fired when a transactional SMS is sent to the carrier.
✉
SmsDeliveredEvent
SMS Delivered
Fired when a transactional SMS is delivered to the recipient.
✉
SmsSoftBounceEvent
SMS Soft Bounce
Fired when a transactional SMS temporarily bounces.
✉
SmsHardBounceEvent
SMS Hard Bounce
Fired when a transactional SMS permanently bounces.
✉
SmsUnsubscribeEvent
SMS Unsubscribe
Fired when a recipient unsubscribes from SMS messages.
✉
InboundEmailProcessedEvent
Inbound Email Processed
Fired when an inbound email is received and processed by Brevo.
✉
ConversationMessageEvent
Conversation Message Received
Fired when a new message is sent in a conversation by a visitor, agent, or bot.
✉
ConversationPushEvent
Conversation Push Notification
Fired when a pushed or automated message is delivered to a visitor in the chat widget.

Servers

https
webhookEndpoint {webhookUrl}
Your application's webhook endpoint that receives event notifications from Brevo via HTTP POST requests.