- Home
- Integrations
- Webhooks
Automation
Custom Webhooks
Webhooks provide the ultimate flexibility for integrating WizStatus with any system. Receive structured JSON payloads for all monitoring events, enabling custom integrations, automation workflows, and connections to tools we don't natively support. Build exactly what you need.
Benefits
- Integrate with any system that accepts HTTP requests
- Structured JSON payloads with all event data
- Trigger automation workflows (Zapier, n8n, Make)
- Build custom dashboards and alerting logic
- Complete control over notification handling
Setup Guide
Follow these steps to set up the integration
Prepare Your Endpoint
Set up an HTTP endpoint that can receive POST requests with JSON payloads. This could be a serverless function, API endpoint, or webhook handler.
// Example Node.js webhook handler
app.post('/wizstatus-webhook', (req, res) => {
const { event, monitor, timestamp } = req.body;
console.log(`Received ${event} for ${monitor.name}`);
// Handle the alert...
res.status(200).send('OK');
});Add Webhook in WizStatus
Go to Settings > Notifications, click "Add Integration", select Webhooks, and enter your endpoint URL.
Tip
Use HTTPS endpoints for secure payload delivery.
Configure Secret (Optional)
Add a webhook secret to verify request authenticity. WizStatus will include a signature header you can validate.
// Verify webhook signature
const crypto = require('crypto');
const signature = req.headers['x-wizstatus-signature'];
const expectedSig = crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(JSON.stringify(req.body))
.digest('hex');
if (signature !== expectedSig) {
return res.status(401).send('Invalid signature');
}Test Your Webhook
Click "Send Test Event" to send a sample payload to your endpoint. Verify your handler processes it correctly.
Tip
Use tools like RequestBin or webhook.site to inspect payloads during development.
Configuration Options
Available configuration settings
| Option | Description | Required |
|---|---|---|
Webhook URL | The HTTPS endpoint to receive webhook events | |
Webhook Secret | Secret for HMAC signature verification | |
Events | Which events should trigger this webhook | |
Retry on Failure | Automatically retry failed webhook deliveries |
Features
Limitations
- Endpoint must respond within 30 seconds
- Maximum 3 retry attempts on failure
- Payload size limited to 1MB
Frequently Asked Questions
Ready to Get Started?
Start monitoring your services in minutes
Get started for freeNo credit card required • 20 free monitors forever