# Outbound event delivered to your webhook URL

> Format of the event Proteside sends to your webhook URL: fields, types and a sample body.

URL: https://docs.proteside.com/en/docs/api/reference/webhooks/webhook-event

## Method and route

`POST webhook: event`

Sent for the subscribed `events` with severity ≥ `min_severity`. Verify `X-Proteside-Signature` before trusting the body.

## Parameters

- `X-Proteside-Event` (header, `string`): Event type
- `X-Proteside-Delivery` (header, `string`): Delivery id (retries reuse it)
- `X-Proteside-Signature` (header, `string`): t=<unix>,v1=<hex hmac_sha256(secret, t + "." + rawBody)>

## Request body

- `id` (`string`), required: evt_<32 hex>
- `type` (`"alert.created" | "alert.resolved" | "script.detected" | "script.authorized" | "script.blocked" | "integrity.changed" | "header.changed" | "report.ready" | "sdk.silent" | "policy.applied" | "test"`), required
- `created_at` (`string`), required
- `org_id` (`string`), required
- `store_id` (`string,null`)
- `severity` (`"critical" | "high" | "medium" | "low" | "info"`)
- `data` (`object`), required: Event-specific: alert.* → { alert, store }; report.ready → { snapshot_id, pdf_url, summary_643, summary_1161, … }; script.* → { script, … }; test → { message }

## Responses

- `2XX`: Acknowledged. Any other status (or a timeout of 8 s) schedules a retry.

Full OpenAPI specification: https://app.proteside.com/api/v1/openapi.json
