{
"event": "kybUpdated",
"eventId": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
"occurredAt": "2026-09-29T19:00:00Z",
"organizationId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"kyb": {
"status": "approved",
"approvedAt": "2026-09-29T19:00:00Z"
}
}Webhook Events
kybUpdated
Fired when a business organization’s KYB status changes.
Statuses: not_started, in_progress (the customer has something left to submit), submitted (everything requested has been submitted or there are open notes, Etherfuse’s turn), approved, denied.
Fires only on an actual status transition, never on individual document or answer edits that leave the status unchanged. approvedAt is set once the organization is approved.
WEBHOOK
kybUpdated
{
"event": "kybUpdated",
"eventId": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
"occurredAt": "2026-09-29T19:00:00Z",
"organizationId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"kyb": {
"status": "approved",
"approvedAt": "2026-09-29T19:00:00Z"
}
}Authorizations
API key sent in the Authorization header, with no Bearer prefix.
Headers
HMAC-SHA256 signature: sha256={hex}. Computed over the canonicalized (RFC 8785) request body using your subscription's secret.
Body
application/json
Response
200
Return any 2xx to acknowledge the delivery.