WEBHOOK
verificationEvent
{
  "id": "evt_12346",
  "object": "event",
  "api_version": "v1",
  "contract_revision": "v1.2026-10-24.1",
  "created": 123,
  "livemode": true,
  "data": {
    "object": {
      "id": "vrf_0123456789abcdef0123456789abcdef",
      "object": "verification",
      "status": "verified",
      "failure_code": "<string>",
      "livemode": true
    }
  }
}

Headers

X-Authbound-Signature
string
required

t=<unix seconds>,v1=<hex HMAC-SHA256>. For 24 hours after a secret rotation the header carries one v1 per secret.

Example:

"t=1779269400,v1=5d4e8f0c2b9a7e6d1f3c5b8a9e0d2c4f6b8a1e3d5c7f9b0a2c4e6d8f0a1b3c5d"

Authbound-Event-Id
string
required
Example:

"evt_12346"

Authbound-Delivery-Attempt
integer
required
Required range: 1 <= x <= 8

Body

application/json
id
string
required
Example:

"evt_12346"

object
enum<string>
required
Available options:
event
api_version
string
required
Example:

"v1"

contract_revision
string
required
Example:

"v1.2026-10-24.1"

created
integer
required

Unix seconds when the event was recorded.

livemode
boolean
required
type
enum<string>
required
Available options:
verification.state_changed,
verification.completed,
verification.failed,
verification.canceled,
verification.expired
data
object
required

Response

200

Any 2xx status acknowledges the event.