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

• Any existing outbound webhooks created from the Contacts, Campaigns, or Transactional pages using the classic experience for webhook management have been migrated to the Webhooks page.
• 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.
• If you want 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 begin, you need to create an outbound webhook in Brevo.

1. In Brevo, click your account name and select Integrations.
2. Go to the Webhooks tab.
3. Click Add webhook.
   
4. Select Outbound webhook.
5. 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. 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.