Overview
Webhooks allow you to integrate StatusStack with any service that accepts HTTP webhooks, including PagerDuty, Datadog, custom systems, and more.Setup Guide
Get Webhook URL
From your target service:
- PagerDuty: Events API v2 endpoint
- Datadog: Webhook integration URL
- Custom: Your webhook endpoint
Configure in StatusStack
- Settings → Notifications
- Create rule
- Select Webhook channel
- Enter webhook URL
- Add custom headers (optional)
- Select HTTP method (POST default)
Webhook Payload
StatusStack sends JSON payloads:Security
Webhook Signatures
StatusStack signs webhooks with HMAC-SHA256:X-StatusStack-Signature header.
Common Integrations
PagerDuty
Datadog
Custom Endpoint
Event Types
StatusStack sends these event types:component.status_changedmonitor.downmonitor.recoveredincident.createdincident.updatedincident.resolvedmaintenance.scheduled
Best Practices
- Verify signatures to prevent spoofing
- Return 200 OK quickly (< 5 seconds)
- Process asynchronously for heavy operations
- Handle retries gracefully (idempotent)
- Log failures for debugging
Troubleshooting
Webhook Failing
Check:- URL is publicly accessible (HTTPS required)
- Endpoint returns 200 OK
- No firewall blocking StatusStack IPs
- Signature verification (if enabled)
Delayed Delivery
Causes:- Your endpoint is slow (> 5 seconds)
- Rate limiting
- Network issues
- Return 200 immediately, process async
- Increase timeout settings
- Check endpoint logs
Next Steps
Notification Setup
Configure notification rules

