Kyb updated
Fired when a business organization’s KYB status changes.
Statuses: not_started, awaiting_documents (the customer has documents left to submit), awaiting_review (everything submitted or there are open notes, Etherfuse’s turn), approved, denied.
Fires only on an actual status transition, never on individual answer edits that leave the status unchanged. The approved, submitted, notStarted, and total counts track onboarding progress; approvedAt is set once the organization is approved.
Authorizations
API key sent in the Authorization header.
Headers
HMAC-SHA256 signature: sha256={hex}. Computed over the canonicalized (RFC 8785) request body using your webhook secret.
Body
Webhook envelope for KYB status changes.
Payload for kyb_updated webhooks: the same shape as the Get KYB progress response. Counts cover the customer-facing requirements only; admin-only requirements are excluded.
{
"organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "approved",
"approved": 12,
"submitted": 0,
"notStarted": 0,
"total": 12,
"approvedAt": "2026-05-02T09:15:00Z"
}Response
Return any 2xx to acknowledge receipt.