Zitadel Preview Docs

Create user

POST
/users

Authorization

oauth2 user.write
AuthorizationBearer <token>

In: header

Scope: user.write

Query Parameters

project_id*string

The unique identifier of the project

team_id?string

The unique identifier of the team

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A user represents an individual identity in the system. It can be used to represent a human user, but also a service account or any other type of identity. The content of a user is determined by the configured schema for users, this is only a base schema.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/users?project_id=river-8421" \  -H "Content-Type: application/json" \  -d '{    "$schema": "string"  }'
{  "id": "string"}
{  "code": "string",  "message": "string",  "details": {}}
{  "code": "string",  "message": "string",  "details": {}}
{  "code": "string",  "message": "string",  "details": {}}
{  "code": "string",  "message": "string",  "details": {}}
{  "code": "string",  "message": "string",  "details": {}}