Webhook Delivery
Payload format, headers, retries, and timeouts.
Delivery payload
json
{
"id": "delivery-uuid",
"type": "audit.created",
"created_at": "2026-09-20T10:00:00Z",
"data": { /* event-specific payload */ }
}Request headers
| Header | Value |
|---|---|
| X-KorClaw-Event | Event type (e.g. audit.created) |
| X-KorClaw-Delivery | Delivery UUID |
| X-KorClaw-Timestamp | Unix timestamp |
| X-KorClaw-Signature | t=<unix>,v1=<hex_hmac> |
| User-Agent | KorClaw-Webhooks/1.0 |
Retry behavior
- Configurable per webhook (retry_max_attempts, default 5)
- Exponential backoff between attempts
- 15-second timeout per delivery attempt
- Use the delivery ID for idempotency