Webhooks and debugging

Atlas POSTs to your webhook_url on lifecycle events.

Setup

1. Pass webhook_url at envelope create.
2. Verify X-Atlas-Signature: sha256=HMAC(raw_body, api_key).
3. Return 2xx within 10 seconds.

Events

envelope.created · envelope.sent · envelope.viewed · envelope.signed · envelope.declined · envelope.voided · contract.extracted

Debug

1. Open Webhook deliveries on the review page.
2. Check status code and error for each attempt.
3. Failed deliveries retry at 1m, 5m, 30m, 2h (up to 4 times).
4. Store metadata.external_id at create to filter: GET /api/envelopes?external_id=...

Related

Platform overview · FAQ