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.

Usage

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

Example payload:

{
  "client": {
    "name": "Pied Piper",
    "url": "https://piedpiper.hund.io/"
  },
  "component": {
    "url": "https://piedpiper.hund.io/components/574f20d2af26c94f785a4ec6",
    "name": "Redis Database",
    "group": "Platform",
    "status": {
      "state": "restored",
      "time_down": 984
    }
  },
  "meta": {
    "unsubscribe": "https://piedpiper.hund.io/subscriptions/57c0baca78842843738b36fb/edit",
    "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.