An Insights alarm was triggered, or returned to normal.
Fields
29The table lists every field of the body. You can validate a delivery against this event’s JSON Schema.
| Field | Type | Description |
|---|---|---|
event required | "alarm_ok" | |
message required | string | A one-line summary of the event, as notifications show it. |
payload_version required | string | The integration's payload version. Allowed value: v3. |
actor | object | The person who caused the event. Absent when Honeybadger did. |
actor.id required | string | null | The user's ID, or null when the person has no Honeybadger account. |
actor.name required | string | null | |
actor.email required | string | null | |
credential | object | The API token or OAuth grant the event was caused through. Absent when the event wasn't caused through the API. |
credential.type required | string | ApiToken for an API token, OauthAccessToken for an OAuth grant. |
credential.id required | string | |
credential.name required | string | null | The token's name. For an OAuth grant, the name the user gave the connection, or the application's name if none. |
project required | object | The project the event belongs to. |
project.id required | string | |
project.name required | string | |
project.language required | string | null | |
project.created_at required | date-time | |
project.links required | object | Links into the Honeybadger web UI. |
project.links.web required | uri | The resource's page in the Honeybadger web UI, as an absolute URL. Resources without a page, such as outages and deploys, don't have links. For a project provisioned through Heroku, error, notice and comment links go through Heroku's single sign-on. |
links required | object | The page to open for this event. |
links.web required | uri | The resource's page in the Honeybadger web UI, as an absolute URL. Resources without a page, such as outages and deploys, don't have links. For a project provisioned through Heroku, error, notice and comment links go through Heroku's single sign-on. |
alarm required | object | The Insights alarm the event is about. |
alarm.id required | string | |
alarm.project_id required | string | |
alarm.name required | string | |
alarm.description required | string | null | |
alarm.state required | string | Allowed values: initial, alarm, ok. |
alarm.created_at required | date-time | |
alarm.links required | object | Links into the Honeybadger web UI. |
alarm.links.web required | uri | The resource's page in the Honeybadger web UI, as an absolute URL. Resources without a page, such as outages and deploys, don't have links. For a project provisioned through Heroku, error, notice and comment links go through Heroku's single sign-on. |
Example
{ "event": "alarm_ok", "message": "[Billing API] OK: Checkout errors is no longer in alert status", "project": { "id": "H99upHsM", "name": "Billing API", "language": "ruby", "created_at": "2026-10-21T12:36:26Z", "links": { "web": "https://app.honeybadger.io/projects/H99upHsM/faults" } }, "alarm": { "id": "opticon-observer-root-id", "project_id": "H99upHsM", "name": "Checkout errors", "description": "More than 10 checkout errors in 10 minutes", "state": "ok", "created_at": "2026-10-21T12:36:26Z", "links": { "web": "https://app.honeybadger.io/projects/H99upHsM/insights/alarms/opticon-observer-root-id" } }, "links": { "web": "https://app.honeybadger.io/projects/H99upHsM/insights/alarms/opticon-observer-root-id" }, "payload_version": "v3"}