Knowledge Base

Outgoing Webhooks

Outgoing webhooks run upon changes to a component's availability, notifying subscribed endpoints. A status page must have the Webhooks notifier enabled before users can add an endpoint via the Subscribe button.


A JSON payload is sent to the subscribed endpoint using the preferred HTTP verb.

Example payload:

  "client": {
    "name": "Pied Piper",
    "url": ""
  "component": {
    "url": "",
    "name": "Redis Database",
    "group": "Platform",
    "status": {
      "state": "restored",
      "time_down": 984
  "meta": {
    "unsubscribe": "",
    "created_at": 1469656449

component.status: This object provides the new component's state string ("degraded" or "restored"), as well as the time_down integer if restored from downtime.

Note: Currently, outgoing webhooks do not send notifications for issues; this is a planned feature.