Send alerts to webhooks - OnlineOrNot Docs

This is a feature of Paid Plans.

Create a webhook

Go to Webhooks in the sidebar and click Add Webhook.

You'll need to provide:

URL - where OnlineOrNot will POST alerts
Events - which events should trigger the webhook (uptime.down, uptime.up, heartbeat.down, heartbeat.up, or status page incident events)
Resources - which uptime checks, heartbeats, or status pages should use this webhook

Once created, the webhook will fire whenever the selected events occur on the selected resources.

Attach webhooks to checks

When creating or editing an uptime check or heartbeat, you can select which webhooks should receive alerts for that check. Only webhooks subscribed to the relevant events (e.g., uptime.down/up for uptime checks) will appear as options.

Webhook payload format

OnlineOrNot POSTs JSON to your webhook URL. The format for API version 2021-05-28:

When an uptime check goes DOWN

{
  "event": "uptime.down",
  "trigger": "down",
  "name": "Some Page",
  "url": "https://yourpagesURL.com"
}

When an uptime check comes UP

{
  "event": "uptime.up",
  "trigger": "up",
  "name": "Some Page",
  "url": "https://yourpagesURL.com"
}

When a heartbeat stops

{
  "event": "heartbeat.down",
  "trigger": "down",
  "name": "Nightly backup job",
  "url": "https://oonchk.com/abc123"
}

When a heartbeat resumes

{
  "event": "heartbeat.up",
  "trigger": "up",
  "name": "Nightly backup job",
  "url": "https://oonchk.com/abc123"
}

See the webhook payload reference for the full list of events and fields.

Note: Field names and formats are stable within a version. New versions are announced before release.