---
title: "Create a user"
description: "Use POST /users to create a user. The operation documented here is User.register.users."
canonical: https://docs.ordering.co/api-reference/guides/create-user/
---

# Create a user

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/users/POST/users)

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.

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

The example is synthetic.

## Legacy SDK example

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

Confirm the SDK package and version before using this helper. For role and field context, see [User model](https://docs.ordering.co/api-reference/guides/users-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](https://docs.ordering.co/api-reference/#tag/users/POST/users)