Integrating Webhooks with Locale
Everything you need to know about integrating your alerts with a webhook endpoint of your choice.
We are excited to announce the addition of a new notification channel - Webhooks! With this new action, users can integrate their alerts with a webhook endpoint of their choice. A webhook request will be sent to the endpoint specified by the user whenever an incident event occurs on Locale.
What you can do with this integration?
- Instantly receive updates about events as they happen through via webhook endpoint.
- Users can now customize downstream notifications by implementing custom logic based on the raw event data.
How to set up a webhook?
When creating an alert (or editing an existing alert):
- Select webhook from the list of notification channels.
![](https://cdn.prod.website-files.com/622aca98e7c65a16d2e273fa/662f7394d563e64f82261d3d_Screenshot%2B2023-01-31%2Bat%2B8.32.51%2BAM.png)
- Select the event type for which you want to receive a webhook request.
- New Incidents: whenever a new incident of this alert is created or resolved locale will send a webhook request to the given endpoint
- Escalated Incidents: Whenever any incident of this alert is escalated locale will send a webhook request to the given endpoint
- Enter your webhook endpoint in the textbox. It has to be a fully qualified link i.e URL should include the protocol (such as "https://" or "http://")
- Once the above-mentioned details are filled in, you can test the setup by clicking on
Send Test Notification
the button which will send a dummy payload to the webhook endpoint.
![](https://cdn.prod.website-files.com/622aca98e7c65a16d2e273fa/662f7394d563e64f8226211f_Screenshot%2B2023-01-31%2Bat%2B8.35.30%2BAM.png)
Webhook Payload Fields
💡 Locale will make a POST request to the webhook endpoint.
An example of a webhook payload:
To conclude, the new webhook notification channel allows users to integrate their alerts with any webhook endpoint, providing real-time information on incidents.
Happy Alerting 🙌🏻