---
title: Event types
description: Reference for Human Token webhook events — payload schema and the possible lastEvent values.
canonical: https://developer.unico.io/human-token/webhooks-and-events/event-types
locale: en
generated_by: markdown-export
---

- [/](/)
- Additional Resources
- [Webhooks and Events](/human-token/webhooks-and-events/)
- Event types

**On this page# Event types

Webhook payloads describe a process state transition. This page documents the payload schema and the full enumeration of `lastEvent` values.
### Payload schema​

FieldTypeDescription`processId``string` (UUID)ID of the transaction.`state``string`Current state of the transaction. Currently: `PROCESS_STATE_FINISHED`.`flow``string`Flow that was executed for this transaction (e.g., `api+humantoken`, `api+liveness+humantoken`, `humantoken`, `humantoken+revalidation`, `api+liveness+humantoken+revalidation`).`lastEvent``string`Last event of the transaction. **Returned only when the process expired before the user completed the flow.**`lastEventDescription``string`Human-readable description of `lastEvent`. **Returned only when the process expired before the user completed the flow.**
Status vocabularyThe `state` field in webhook payloads uses the `PROCESS_STATE_*` prefix. This is a distinct vocabulary from the `result` and `status` fields returned by the GetProcess endpoint, which use `PROCESS_RESULT_*`. Do not treat them as interchangeable.
### Example payload​

#### Finished — successful​

```
{  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "state": "PROCESS_STATE_FINISHED",  "flow": "humantoken"}
```

#### Finished — expired​

```
{  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "state": "PROCESS_STATE_FINISHED",  "flow": "humantoken",  "lastEvent": "EVENT_TYPE_SESSION_ENDED",  "lastEventDescription": "Session ended by timeout or by new session created"}
```

### lastEvent enumeration​

The full list of values that may appear in `lastEvent`:
EventDescription`EVENT_TYPE_PROCESS_CREATED`Process created`EVENT_TYPE_PROCESS_STARTED_BY_USER`Process started by user`EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED`Identity validation step finished`EVENT_TYPE_SESSION_ENDED`Session ended by timeout or by new session created
Configurable handlingThe set of events may evolve. Treat the events your endpoint reacts to as **configuration**, not hard-coded constants — that way new events can be enabled without a deploy.
### Reading the full process result​

The webhook payload signals that a process finished, but does not include the outcome itself. To retrieve the result — along with capture data, biometric scores, document fields, etc. — call the appropriate **GetProcess** endpoint see [Get Process](/human-token/api-reference/get-process).Last updated on Oct 17, 2026**