AvailableMedium

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.

5 minutes Setup Time
Starter Plan Required

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

1

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');
});
2

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.

3

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');
}
4

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

OptionDescriptionRequired
Webhook URLThe HTTPS endpoint to receive webhook events
Webhook SecretSecret for HMAC signature verification
EventsWhich events should trigger this webhook
Retry on FailureAutomatically retry failed webhook deliveries

Features

Structured JSON payloads with comprehensive event data
HMAC signature verification for security
Automatic retries with exponential backoff
Delivery logs for debugging
Custom headers support
Event filtering (select which events trigger webhooks)

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 free

No credit card required • 20 free monitors forever