Webhook Integration

Webhooks are a simple and powerful way to send real-time notifications from Xitoring to your application. With webhook integration, you can receive alerts and incidents as they happen, enabling you to take immediate action and minimize downtime.

To set up webhook integration in Xitoring, follow these steps:

Create a Webhook URL

The first step is to create a webhook URL in your server or application. This is the URL where Xitoring will send the webhook notifications. Make sure the URL is publicly accessible and can receive HTTP POST requests.

Configure Webhook in Xitoring

Once you have a webhook URL, log in to your Xitoring account and go to the Notification Roles page. Click on the Notification role you want to add Webhook to it (or create a new notification role), and from the bottom of the page enter your Webhook URL in the field and then click on Send a Test Notification to get a test incident and make sure you have set up everything right.

Example request from Xitoring

The following is a full example of what Xitoring will POST to your Webhook URL:

As curl

curl -X 'POST' 'https://yourwebhook.app/cb92459602ccc67a8f7b' -H 'connection: close' -H 'content-type: application/x-www-form-urlencoded' -H 'content-length: 163' -H 'accept: */*' -H 'host: yourwebhook.app' -d $'id=0&group=test+group&sub_group=test+subgroup&server_id=0&check_id=0&label=server+label&name=&type=20&type_human_readable=ping&unit=&value=&status=0&incident_time='

Raw

id=0&group=test+group&sub_group=test+subgroup&server_id=0&check_id=0&label=server+label&name=&type=20&type_human_readable=ping&unit=&value=&status=0&incident_time=

Request breakdown

The following table is a guide to make it easy to integrate Xitoring webhook feature to your application.

Type mapping and definition