Setup
- Go to Settings → Webhooks in the AccessOwl admin interface.
- Click “Add Webhook”.
- Enter the endpoint URL where AccessOwl should send event payloads.
- Select the events you want to subscribe to.
- Save. AccessOwl will start delivering events immediately.
Payload structure
Every webhook payload is a JSON object with the following top-level fields:Retries
If your endpoint returns an HTTP4xx or 5xx response, or the connection fails, AccessOwl retries the delivery up to 9 times (a maximum of 10 delivery attempts in total) using exponential backoff. The delay starts at ~2 minutes and roughly doubles with each retry, capped at 3 hours:
A small random jitter (~6%) is added to each retry so deliveries are spread out rather than firing in lockstep. These delays are approximate and may change. The full sequence spans roughly 10 hours from the original event; once the final attempt has been made, the delivery is marked as failed.
You can inspect all delivery attempts from Settings → Webhooks.

