Webhook endpoints

Subscribe to session lifecycle + quota events. Each endpoint gets its own signing secret; verify with the SDK's verifyWebhookSignature helper.

New webhook endpoint

URL

HTTPS required. The endpoint must respond 2xx within 10s for delivery to count as successful.

Events to subscribe to

session.completed session.failed api_key.revoked quota.warning_80pct quota.exceeded

Description (optional)

Endpoint created

Copy this signing secret now — it won't be shown again. Use it with the SDK's verifyWebhookSignature helper to authenticate incoming deliveries.

Edit endpoint

URL

Events to subscribe to

session.completed session.failed api_key.revoked quota.warning_80pct quota.exceeded

Description

Active (uncheck to pause delivery without deleting)

No webhook endpoints

Subscribe to events when sessions complete, fail, or quota thresholds trip. POST + URL + event list = endpoint.

Create endpoint

https://hooks.example.test/driftstack
active

production hook

whk_00000000-0000-4000-8000-0000000000d1 · created 2026-04-15

Edit Delete

session.completed session.failed quota.warning_80pct

Delivered

4,321

Failed

12

DLQ

1

View delivery log → Requeue DLQ (1)
https://staging.example.test/driftstack
paused

staging — paused while testing

whk_00000000-0000-4000-8000-0000000000d2 · created 2026-04-22

Edit Delete

session.completed

Delivered

213

Failed

0

DLQ

0

View delivery log →

Failed deliveries retry 5× with exponential backoff before landing in the DLQ. DLQ entries are admin-replayable; no auto-retry past the initial attempts to avoid storm-on-recovery patterns.

Driftstack

Privacy Terms DPA AUP Sub-processors