Webhook

On this page

Send Onagre notifications to any HTTP endpoint of yours — an incident management tool, an automation platform, an internal bot. Requires a paid plan.

In Onagre#

Integrations → Add integration → Webhook:

Field	Value
Name	At least 3 characters, for example `Incident bridge`.
Webhook URL	Your endpoint, for example `https://incidents.corvane.example/hooks/onagre`. It must be reachable from the internet.

Then add the integration to the alerting of your sensors.

The request#

Onagre sends an HTTP POST with a JSON body when an incident opens and when it is resolved:

JSON

{
  "sensor": {
    "code": "7c0b0a7ea1",
    "name": "Notifications — SMS gateway",
    "url": "https://app.onagre.io/sensors/json/7c0b0a7ea1",
    "isUp": false
  },
  "poll": {
    "universalDateTime": "2026-10-12T09:23:00",
    "ellapsedTime": null,
    "httpCode": "Unexpected value at $.component.status: \"degraded_performance\""
  }
}

Field	Meaning
`sensor.code`, `sensor.name`	The sensor.
`sensor.url`	Its page in Onagre.
`sensor.isUp`	`false` when the incident opens, `true` when it is resolved.
`poll.universalDateTime`	Time of the check, in your organization's time zone.
`poll.ellapsedTime`	On resolution, the downtime in seconds; `null` when the incident opens.
`poll.httpCode`	The error reported by the check (despite its name, a message rather than an HTTP code).

Good to know#

The request carries no signature or authentication header. Use a hard-to-guess URL, and check sensor.code on your side.
Your endpoint must answer within 10 seconds. Redirects are not followed, and private or local addresses are refused.
A failed delivery is not retried; it is recorded as Failed in the incident's notifications.