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

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/v2/alarm_alert.schema.json).

| Field | Type | Description |
| - | - | - |
| `event` required | "alarm\_alert" | |
| `message` required | string | A one-line summary of the event, as notifications show it. |
| `actor` | object | The person who caused the event. Absent when Honeybadger, or an API token with no user, did. |
| `actor.id` required | integer | |
| `actor.email` required | string | |
| `actor.name` required | string \| null | |
| `alarm` required | object | The Insights alarm the event is about. |
| `alarm.id` required | string \| null | |
| `alarm.name` required | string \| null | |
| `alarm.state` required | string \| null | Allowed values: `initial`, `alarm`, `ok`, `null`. |
| `alarm.created_at` required | date-time | |
| `alarm.url` required | uri | |
| `alarm.details_url` required | uri | The same as `url`. |

## Example

```json
{
  "event": "alarm_alert",
  "message": "[Billing API] ALERT: Checkout errors is in alert status",
  "alarm": {
    "name": "Checkout errors",
    "state": "alarm",
    "created_at": "2026-10-21T12:36:26.448717Z",
    "id": "opticon-observer-root-id",
    "url": "https://app.honeybadger.io/projects/85736/insights/alarms/opticon-observer-root-id",
    "details_url": "https://app.honeybadger.io/projects/85736/insights/alarms/opticon-observer-root-id"
  }
}
```

---

## 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/)