---
title: alarm_ok
description: The v3 webhook payload for the alarm_ok event, in preview. An Insights alarm was triggered, or returned to normal.
url: https://docs.honeybadger.io/guides/integrations/payloads/v3/alarm_ok/
---

The v3 payload is in preview

Its fields can change before general availability. v2, the default, is unchanged.

An Insights alarm was triggered, or returned to normal.

## Fields

The table lists every field of the body. You can validate a delivery against this event’s [JSON Schema](https://docs.honeybadger.io/guides/integrations/payloads/v3/alarm_ok.schema.json).

| 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

```json
{
  "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"
}
```

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)