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.

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.