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.

You can create outbound webhooks for events related to the following Brevo features:

Good to know

• You can create up to 40 outbound webhooks per Brevo account. If you reach this limit, delete an existing webhook before creating a new one.
• Outbound webhooks can also be created using an automation or the API.
• To create inbound webhooks to receive real-time data from another app in Brevo, check our dedicated article Create inbound webhooks to receive real-time data in Brevo.

Before you start

From your external app, make sure to retrieve:

• The URL of the server or endpoint you want to send the outbound webhook to
• (Optional) The authentication method and credentials required
• Any required header name and value

If you're unsure where to retrieve this information, check your external app’s help center or contact their support team.

Step 1: Create an outbound webhook in Brevo

To create an outbound webhook in Brevo:

1. In Brevo, click your account name and select Integrations > Webhooks.
2. Click Add webhook.
   
3. Select Outbound webhook.
4. Click Add webhook.
   

Step 2: Set up the outbound webhook

Then, set up the name, URL, and authentication method of the outbound webhook.

1. Enter a name for the webhook.
2. Click Continue.
3. Enter the URL of the server or endpoint you want to send your events to. This tells Brevo where to send the outbound webhook when an event happens.
   
4. (Optional) By default, No authentication is selected as the authentication method. To add an extra layer of security, or if the external app you're sending the webhook to requires it, you can choose either:
   • Basic authentication (username and password), or
   • Token authentication
     
5. (Optional) To add a header to your outbound webhook:
   1. Click + Add an object.
   2. Enter the header name and value.
      
6. Select your webhook sending strategy:
   • Send one at a time
     Send events individually in real time.
   • Send by batch
     Send events in batches of up to 500. This is recommended if you have lower rate limits, as it can reduce the number of requests.
7. Click Continue.

Step 3: Choose the events and send test requests

Finally, choose the events for which you want to receive the outbound webhook and send test requests to your external app.

1. Select the event category for which you want to create an outbound webhook (e.g., Transactional email, Deals, Forms, etc.).
   
   💡 Good to know

   Contacts events are located under the Marketing emails event category.
2. By default, all events within the selected category are activated. If needed, you can deactivate specific events by untoggling them.
   
3. (Optional) To send test requests for the events:
   1. Click the three dots icon next to an event and select Send test request.
      
   2. Check your external app to confirm if you've received the outbound webhook.
4. Click Activate webhook when you’re done.

Secure your outbound webhooks

To secure your outbound 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.

Monitor webhook delivery and configure alerts

Monitor the delivery of your outbound webhook events and configure alerts to be notified when issues occur.

Review your webhook statistics

The monitoring dashboard helps you track the delivery status of your outbound webhook events. This allows you to quickly identify delivery issues.

To review your webhook statistics:

1. In Brevo, click your account name and select Integrations > Webhooks.
2. From the Outbound webhooks tab, click the outbound webhook you want to monitor.

3. Under Statistics, review the delivery state of your webhooks:

   📨 Delivery states📊 Bar chart

   

   View the number of webhook events for the last 24 hours in three delivery states:

   • ❌ Failed: The number of unique webhook events that could not be delivered after 24 hours of retries and were discarded.
   • ⚠️ Retries: The number of unique webhook events currently being retried within the last 24 hours. To learn more about the retry mechanism, check our dedicated API documentation.
   • ✅ Delivered: The number of unique webhook events successfully delivered in the last 24 hours.

   

   The rolling 24-hour bar chart shows the number of webhook events in each state with an hourly breakdown. You can hover over a bar to view the exact number of unique webhook events being retried, delivered, and failed during the hour.

Configure webhook alerts

Set up email alerts to be notified when webhook delivery issues reach a defined threshold. Alerts are sent to your default account email with a maximum of one notification per hour when a threshold is reached.

To configure webhook alerts:

1. Under Alert configuration, activate the alerts you want to receive:
   • Retry alert
     Set a threshold to receive a notification when the number of retrying webhook events reaches this value. The minimum threshold is 50.
   • Fail alert
     Set a threshold to receive a notification when the number of failed webhook events reaches this value. The minimum threshold is 50.
     
2. Click Save.

Deactivate an outbound webhook

If you need to temporarily stop sending data from Brevo to your external app, you can deactivate the outbound webhook.

1. In Brevo, click the account dropdown and select Integrations.
2. Go to the Webhooks tab.
3. Select the Outbound webhook option.
4. Toggle off the outbound webhook you want to deactivate.
    

The outbound webhook is now deactivated (grey toggle). You can reactivate it at any time by toggling it back on.

Delete an outbound webhook

If you no longer need an outbound webhook, you can delete it permanently.

1. In Brevo, click your account name and select Integrations.
2. Go to the Webhooks tab.
3. Select the Outbound webhook option.
4. Next to the outbound webhook you want to delete, click the bin icon 🗑️.
   
5. Click Delete webhook to confirm.

The outbound webhook has been permanently deleted.

🤔 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.