What is Webhook Notification?
Webhooks allow Xitoring to send HTTP POST requests with JSON payloads to any URL you specify whenever an incident occurs. This is the most flexible notification channel, enabling you to build custom integrations, trigger automations, or feed data into your own systems.
Why Use Webhook Notifications?
- Ultimate flexibility — Send alerts to any system with an HTTP endpoint
- Custom integrations — Build your own alerting pipeline
- Automation — Trigger scripts, runbooks, or auto-remediation
- Data enrichment — Feed incident data into dashboards or analytics
How to Configure Webhook Notifications
Step 1: Prepare Your Endpoint
- Set up an HTTP endpoint that can receive POST requests
- Ensure it returns a 2xx status code on success
- Note down the URL
Step 2: Create a Notification Role
- Log in to your Xitoring Dashboard
- Go to Settings → Notification Roles
- Click Create New Role
- Name it (e.g., "Custom Webhook")
Step 3: Add the Webhook
- Click Add Contact in the notification role
- Select Webhook as the channel
- Enter your endpoint URL
- Configure any custom headers if needed
Step 4: Test the Webhook
- Click Send Test to send a test payload
- Verify your endpoint received the request
- Check the payload structure for your integration
Webhook Payload
The webhook sends a JSON payload containing:
- Incident type and severity
- Monitor details (name, type, target)
- Timestamp and duration
- Status change information
Best Practices
- Implement retry logic on your endpoint for reliability
- Use HTTPS endpoints for security
- Validate incoming payloads using request signatures
- Log received webhooks for debugging
- Set up a fallback channel (email/SMS) in case your endpoint is down
Learn More
Explore all available Notification Channels to complement your webhook integration.