Skip to main content

Overview

Webhooks allow you to integrate StatusStack with any service that accepts HTTP webhooks, including PagerDuty, Datadog, custom systems, and more.

Setup Guide

1

Get Webhook URL

From your target service:
  • PagerDuty: Events API v2 endpoint
  • Datadog: Webhook integration URL
  • Custom: Your webhook endpoint
2

Configure in StatusStack

  1. SettingsNotifications
  2. Create rule
  3. Select Webhook channel
  4. Enter webhook URL
  5. Add custom headers (optional)
  6. Select HTTP method (POST default)
3

Test

Send test webhook

Webhook Payload

StatusStack sends JSON payloads:

Security

Webhook Signatures

StatusStack signs webhooks with HMAC-SHA256:
Signature sent in X-StatusStack-Signature header.

Common Integrations

PagerDuty

Datadog

Custom Endpoint


Event Types

StatusStack sends these event types:
  • component.status_changed
  • monitor.down
  • monitor.recovered
  • incident.created
  • incident.updated
  • incident.resolved
  • maintenance.scheduled
Filter events in notification rule settings.

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:
  1. URL is publicly accessible (HTTPS required)
  2. Endpoint returns 200 OK
  3. No firewall blocking StatusStack IPs
  4. Signature verification (if enabled)

Delayed Delivery

Causes:
  • Your endpoint is slow (> 5 seconds)
  • Rate limiting
  • Network issues
Solutions:
  • Return 200 immediately, process async
  • Increase timeout settings
  • Check endpoint logs

Next Steps

Notification Setup

Configure notification rules