---
title: "Alert event triggered"
method: POST
path: "alertEvent"
tags: ["EventNotification"]
---

# Alert event triggered

`POST alertEvent` (webhook)

Sent to your webhook URL when an alert event fires. Verify the HMAC signature (see headers below) and reply with a 2xx status; anything else is retried up to 4 times with exponential back-off. The same event may arrive more than once: use eventId as your idempotency key. The signing key is returned a single time, on the response that creates the first webhook destination of your account; rotate it from your dashboard.

## Headers

- `X-Webhook-Timestamp` string, required
- `X-Webhook-Signature` string, required
- `User-Agent` string, required

## Payload

- object
  - `eventType` 'NEW_MATCH' | 'PRICE_CHANGE' | 'OTHER_CHANGE' | 'EXPIRED' | 'REACTIVATED', required: Type of alert event that triggered the notification.
  - `eventId` string, uuid, required: Unique identifier of this delivery. The same eventId may be delivered more than once on retry — use it as your idempotency key.
  - `alert` object, required
    - `id` string, uuid, required: Id of the alert that matched.
    - `name` string, nullable, required: Name of the alert that matched. Null when the alert has no name.
  - `listing` object, required
    - `id` string, uuid, required: Id of the listing whose update triggered this event, within the data.listings array below.
  - `data` object, required: Full property representation — the exact body returned by GET /properties/{id}. Embedded so you can ingest the match without an extra (billed) API call. It reflects the freshest indexed state at delivery time, not a point-in-time snapshot of the event. Protected sources are masked according to your account permissions, exactly as on the API.

## Acknowledgement `2XX`

Any 2xx status acknowledges receipt. The response body is ignored.

## Other responses

- `default`: Any non-2xx status (and any timeout or connection error) is treated as a delivery failure and triggers a retry.

---

[API](https://skmtc.dev/stream/apis/stream-estate-api.md) · [All operations](https://skmtc.dev/stream/apis/stream-estate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stream/apis/stream-estate-api/revisions/be729cccdc1e?raw)