Users API

Create a user

POST/users

Creates a new user account.

Try it

Headers

Name	Type	Description
Authorizationrequired	string	Authentication credentials, e.g. `Bearer <token>`.

Request body

Name	Type	Description
namerequired	string	Display name of the user.
emailrequired	string	Email address of the user.

Example request

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

Responses

201The created user.

Name	Type	Description
idrequired	string	Unique identifier for the user.
namerequired	string	Display name of the user.
emailrequired	string	Email address of the user.
createdAt	string	Date and time when the user was created.

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 27, 2026

Edit this page

PreviousList users NextDelete a user