---
title: "Organization KYB updated"
method: POST
path: "organization.kyb.updated"
---

# Organization KYB updated

`POST organization.kyb.updated` (webhook)

Fired when the KYB verification status of an organization changes, including endorsement and capability updates.

## Payload

- object
  - `type` 'organization.kyb.updated', required: The type of webhook event.
  - `organization_id` string, required
  - `provider` 'bridge', required: KYC/KYB provider identifier.
  - `environment` 'production' | 'sandbox', required: Provider environment (production or sandbox).
  - `data` OrganizationKybUpdatedData, required: Full KYB state snapshot in a KYB update event.
    - `status` string, required: KYC/KYB status for the user.
    - `tos` OrganizationKybUpdatedTosData, required: Terms of service status in a KYB update event.
      - `status` string, required: Status of Terms of Service acceptance. Passthrough from the provider.
    - `kyb` OrganizationKybUpdatedKybData, required: KYB verification status in a KYB update event.
      - `status` string, required: Status of KYC/KYB verification. Passthrough from the provider.
    - `endorsements` KyxEndorsement[], required
      - `name` string, required: Endorsement identifier.
      - `status` string, required: Status of an endorsement. Passthrough from the provider.
      - `missing` string[], nullable, required: Missing requirements, or null if complete.
      - `issues` string[], nullable, required: Provider issue codes, or null if none.
    - `capabilities` KyxCapabilities, required: Capability statuses for the customer.
      - `payin_crypto` string, required: Status of a capability. Passthrough from the provider.
      - `payout_crypto` string, required: Status of a capability. Passthrough from the provider.
      - `payin_fiat` string, required: Status of a capability. Passthrough from the provider.
      - `payout_fiat` string, required: Status of a capability. Passthrough from the provider.
  - `changes` object, required

## Acknowledgement `200`

Return a 200 status to indicate that the webhook was received successfully.

---

[API](https://skmtc.dev/privy-io/apis/privy-api.md) - [All operations](https://skmtc.dev/privy-io/apis/privy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/privy-io/apis/privy-api/revisions/6a80d4be53a8?raw)