Outbound Webhooks

Configure workspace webhook delivery from the settings surface for annotation and build events.

SETTING UP A WEBHOOK

Workspace-level webhooks are configured from Dashboard sidebar Settings / Outbound Webhooks.

1Go to Dashboard sidebar Settings / Outbound Webhooks

2Add a webhook URL

3Optionally set a signing secret

4Choose the event types shown in the UI

5Save and inspect delivery logs from the webhook row

EVENT TYPES

PAYLOAD SHAPE

annotation:created

json

{
  "event": "annotation:created",
  "data": {
    "annotationId": "ann_01HZ...",
    "title": "Link is dead on iPad",
    "createdByUserId": "usr_..."
  },
  "ts": 1760000000000
}

Signing and retries

When a secret is configured, Claron sends X-Claron-Signature: sha256=<hex>, an HMAC-SHA256 of the exact JSON request body. Delivery uses a 10-second timeout; network failures and non-2xx responses are retried up to five attempts with exponential backoff. Each attempt is recorded in the delivery log.

DELIVERY LOGS

Status: Per-attempt response status in the delivery drawer
Duration: Per-attempt delivery timing
Response body: Captured response content when available
Scope: Workspace-level webhook configuration