---
title: "Create a new user state ID or update an existing one with some initialization data"
method: POST
path: "/init/{flowId}"
tags: ["Using the API"]
---

# Create a new user state ID or update an existing one with some initialization data

`POST /init/{flowId}`

## Path parameters

- `flowId` string, required

## Headers

- `x-hf-session` string

## Request body

- InitData

## Response `200`

Returns the new x-hf-session created or the same one if provided in the x-hf-session

## Other responses

- `400` — Client provided invalid data
- `401` — Invalid token provided
- `500` — Internal server error (which might be caused by a temporary issue)

---

[API](https://skmtc.net/trulioo/apis/trulioo-platform-api.md) · [All operations](https://skmtc.net/trulioo/apis/trulioo-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trulioo/trulioo-platform-api/versions/a825565ee177/schema)