Create a user

API operation: Open the endpoint in Scalar

Use POST /users to create a user. The operation documented here is User.register.users.

The documented schema defaults a requested user level to customer level 3, but allowed roles depend on the authenticated caller and project signup settings. Do not infer that only administrators can create every non-customer role.

A standard registration requires contact and password data according to the current schema. Privileged flows can accept either email or cellphone and can create a user without a password so the user can complete credentials later. Project settings can also allow configured business, driver, or professional signup flows.

{
  "name": "Example",
  "lastname": "User",
  "email": "user@example.com",
  "password": "[REDACTED]"
}

The example is synthetic.

Legacy SDK example

const response = await ordering.users().save()

Confirm the SDK package and version before using this helper. For role and field context, see User model.

OpenAPI reference

Operation: POST /users

Request body fields

Name	Type	Required
cellphone	string	No
city_id	integer	No
country_code	string	No
country_phone_code	string	No
email	string	No
lastname	string	No
level	integer	No
location	object	No
name	string	No
password	string	No
schedule	object	No
settings	object	No

Responses

Code	Description
200	OK
400	Bad Request (ErrorResponse)
401	Unauthorized
404	Not Found
429	Too Many Requests (ErrorResponse)
500	Internal Server Error (ErrorResponse)
503	Service Unavailable (ErrorResponse)

Open this operation in the API reference