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.

🤔 ¿Tiene alguna duda?

Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.

Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con la agencia partner de Brevo adecuada.

💬 ¿Fue útil este artículo?

Usuarios a los que les pareció útil: 15 de 49