Receive a verification event
Authbound POSTs each event type a webhook endpoint subscribes to, at least once. Events never contain claims;
read them from GET /v1/verifications/{id}/result.
Verify X-Authbound-Signature before trusting the body: compute HMAC-SHA256 over <t>.<raw body> with the
endpoint’s full whsec_ secret as the key and compare it with each v1 value. Reject timestamps more than 5
minutes old. Dedupe on Authbound-Event-Id.
Any 2xx response acknowledges the event. 408, 429, 5xx, timeouts (10 seconds) and connection errors are retried after 30 seconds, doubling to at most an hour, for 8 attempts in all. Other responses are final.
Headers
t=<unix seconds>,v1=<hex HMAC-SHA256>. For 24 hours after a secret rotation the header carries one v1
per secret.
"t=1779269400,v1=5d4e8f0c2b9a7e6d1f3c5b8a9e0d2c4f6b8a1e3d5c7f9b0a2c4e6d8f0a1b3c5d"
"evt_12346"
1 <= x <= 8Body
"evt_12346"
event "v1"
"v1.2026-10-24.1"
Unix seconds when the event was recorded.
verification.state_changed, verification.completed, verification.failed, verification.canceled, verification.expired Response
Any 2xx status acknowledges the event.