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

# User State Update

POST 

Occurs whenever a user's state is updated

Reference: https://docs.flagright.com/api-reference/webhooks/user/user-state-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: `USER_STATE_UPDATED`
- `data` (WebhookUserStateDetails, required)
- `account` (string, optional) — Email ID associated with the event

## Types

### WebhookUserStateDetails

- `state` (enum, required)
  - Allowed values: `UNACCEPTABLE`, `TERMINATED`, `ACTIVE`, `DORMANT`, `CREATED`, `SUSPENDED`, `BLOCKED`
- `userId` (string, required)
- `reason` (string, optional)