User

Create user

Creates a new user in the current workspace and sends a confirmation email. When the email already has an account that is not a member of the current workspace, that account is added to it instead (200 with only {id, email, roles} — K9, owner 16.10.2026; mail "You have been added to <workspace>" with a sign-in link, no password or code). The fullName of an existing account is not changed.

POST
/api/v2/users

Authorization

BearerAuthObject
AuthorizationBearer <token>

Machine tokens only: a personal API token or a product robot token (POST /api/v2/products/{uid}/robot-tokens). A session JWT here is 401 — the web app uses the b2t_access cookie.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "https://example.com/api/v2/users" \  -H "Content-Type: application/json" \  -d '{    "email": "string",    "fullName": "string",    "roles": [      "string"    ]  }'
Empty
Empty
Empty
Empty
Empty