User

Create a user

POST/users

Creates a new user account.

Parameters

Authorizationheaderstringrequired

Authentication credentials, e.g. Bearer <token> (bearerAuth (http bearer)).

Request body

namestringrequired

emailstringrequired

Example request

{
  "name": "Ada Lovelace",
  "email": "[email protected]"
}

Responses

201The created user.

idstringrequired

namestringrequired

Display name of the user.

emailstringrequired

Email address of the user.

createdAtstring

201 example

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Ada Lovelace",
  "email": "[email protected]",
  "createdAt": "2024-01-15T09:30:00Z"
}

422The user could not be created.

Code samples

cURL

curl -X POST 'https://api.example.com/v1/users' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Ada Lovelace",
  "email": "[email protected]"
}'

Last updated on Sep 2, 2026

PreviousList users NextDelete a user