Webhook Notifications

Statuspage.io can send out notifications to your customers via webhooks when you create or update an incident, or update a component status. Webhooks contain information about the item that changed.

Note: we don't currently support Slack endpoints.

Enabling

Enabling webhook subscriptions is done via the management interface.

Subscribing

Once this is enabled, the subscription dropdown will contain a new tab for webhook notifications that your users will use to subscribe. Webhook subscribers can also be created through the API.

Webhook Basics

Webhooks are HTTP POST requests that our servers send to the registered endpoint. They contain basic information about how to unsubscribe the endpoint, where to find documentation, which organization the webhook pertains to, and type-specific information about a component update or an incident update.

Endpoints are required to respond with a 2xx response code (3xx is considered a failure), and must respond within 30 seconds of initial connection.

Component Updates

Component update webhooks are useful so that your system can respond to changes in dependent infrastructure without requiring manual intervention. For example, when using an external CDN service, detecting that the CDN service is down or performing poorly may trigger you to bring online more capacity to handle additional requests.

Webhooks are dispatched each time a component changes status (but not for changes to name, position on the page, etc). A reference to the old value and the new value will allow your service to respond accordingly.