> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.flagright.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.flagright.com/_mcp/server.

# KYC Status Update

POST 

Occurs whenever a kyc status is updated

Reference: https://docs.flagright.com/api-reference/webhooks/user/kyc-status-update

## Request

### Headers

- `x-flagright-signature` (string, required) — An [HMAC SHA256 signature](/guides/webhooks/signatures#verifying-signatures) generated using the webhook payload and a shared signing secret. This is then converted to a hex encoded string.

### Payload

- `id` (string, required) — Unique identifier for the event
- `triggeredBy` (enum, required) — Event triggered by a user or system
  - Allowed values: `MANUAL`, `SYSTEM`
- `createdTimestamp` (double, required) — Time at which the event was created. Measured in ms since the Unix epoch.
- `type` (enum, required)
  - Allowed values: `KYC_STATUS_UPDATED`
- `data` (WebhookKYCStatusDetails, required)
- `account` (string, optional) — Email ID associated with the event

## Types

### WebhookKYCStatusDetails

- `userId` (string, required)
- `reason` (string, optional)
- `status` (enum, optional)
  - Allowed values: `SUCCESSFUL`, `FAILED`, `NOT_STARTED`, `IN_PROGRESS`, `EXPIRED`, `NEW`, `CANCELLED`, `MANUAL_REVIEW`, `EDD_IN_PROGRESS`