Search

Classic webhooks - Create outbound webhooks to send real-time data from Brevo to an external app

This article covers the classic experience for webhook management. To learn more about the new experience, check our dedicated article New webhooks - Create outbound webhooks to send real-time data from Brevo to an external app.

Outbound webhooks allow you to send real-time data from Brevo to an external app. When a specific event happens in Brevo, your external app will receive a notification containing event details.

Good to know

  • You can create up to 40 outbound webhooks in your Brevo account. If this limit is exceeded, delete an existing webhook to create a new one.
  • You can also create outbound webhooks from an automation or from the API.

Create an outbound webhook

You can create a webhook directly in Brevo to notify your external app when a contact triggers specific one of the following events:

Marketing events (marketing emails and contacts)
When an email is: When a contact is:
  • Marked as Spam
  • Hard Bounced
  • Delivered
  • Opened
  • Unsubscribed
  • Clicked
  • Soft Bounced
  • Added to a list
  • Updated
  • Deleted
Transactional events (transactional emails)
When an email is:
  • Sent
  • Delivered
  • First opening
  • Known open
  • Loaded by proxy
  • Clicked 
  • Soft bounce
  • Hard bounce
  • Invalid email
  • Error
  • Deferred
  • Complaint
  • Unsubscribed
  • Blocked

To create a webhook:

  1. In Brevo, go to the Webhooks page:
  2. Click Add a new webhook.
  3. Paste the webhook URL provided by your external app. This callback URL tells Brevo where to send data when an event happens.
    webhook_ui_url_en-us.png
    💡 Good to know
    The webhook URL must be generated and retrieved from your external app. If you're unsure where to retrieve it, check your external app’s help center or contact their support team.
  4. Select the events you'd like to receive notifications for.
  5. Enter a description for the webhook.
    webhook_ui_event_description_en-us.png
  6. Click Save.

After creating the webhook, we recommend testing it by clicking Actions > Send a test or Test. You will receive a notification when the event is triggered.

Secure your webhooks

To secure your webhooks, you need to whitelist some of Brevo's IP ranges. This ensures that only authorized requests can trigger webhooks. To learn more, check our dedicated article Brevo IP ranges: List of publicly exposed services.

💡 Good to know
These IP ranges relate to marketing webhooks, transactional webhooks, and webhooks called directly from an automation.

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.

💬 Was this article helpful?

15 out of 49 found this helpful