---
title: "Create a new user"
method: POST
path: "/v1/users"
tags: ["Users (User)"]
---

# Create a new user

`POST /v1/users`

## Request body

- CreateUserRequest
  - `username` string
  - `password` string, password, required — At least one number and one letter
  - `organization` string, required
  - `role` 'client' | 'admin', required

## Response `201`

Created

- object
  - `user` User
    - `id` string
    - `email` string, email
    - `name` string
    - `role` 'user' | 'admin'
  - `tokens` AuthTokens
    - `access` Token
      - `token` string
      - `expires` string, date-time
    - `refresh` Token
      - `token` string
      - `expires` string, date-time

## Other responses

- `400` — unresolved $ref

## Changes

- **2026-07-17** `e825144e9ffd` — 2 info
  - added the non-success response with the status `400`
  - added the success response with the status `201`
- **2023-08-01** `eaa698f0f7cb` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - removed the non-success response with the status `400`

[Change history](https://skmtc.dev/openloyalty/apis/loyalty-blockchain-api/changes/v1/users/post.md)

---

[API](https://skmtc.dev/openloyalty/apis/loyalty-blockchain-api.md) · [All operations](https://skmtc.dev/openloyalty/apis/loyalty-blockchain-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openloyalty/loyalty-blockchain-api/revisions/e825144e9ffd/schema)