{
  "kyb_updated": {
    "organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "approved",
    "approved": 12,
    "submitted": 0,
    "notStarted": 0,
    "total": 12,
    "approvedAt": "2026-05-02T09:15:00Z"
  }
}

Webhook Events

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.

WEBHOOK

kybUpdated

{
  "kyb_updated": {
    "organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "approved",
    "approved": 12,
    "submitted": 0,
    "notStarted": 0,
    "total": 12,
    "approvedAt": "2026-05-02T09:15:00Z"
  }
}

Authorizations

Authorization

string

header

required

API key sent in the Authorization header.

Headers

X-Signature

string

required

HMAC-SHA256 signature: sha256={hex}. Computed over the canonicalized (RFC 8785) request body using your webhook secret.

Body

application/json

Webhook envelope for KYB status changes.

kyb_updated

object

required

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.

Show child attributes

Example:

{
  "organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "approved",
  "approved": 12,
  "submitted": 0,
  "notStarted": 0,
  "total": 12,
  "approvedAt": "2026-05-02T09:15:00Z"
}

Response

200

Return any 2xx to acknowledge receipt.

Kyc updated Verify API key

⌘I