---
title: "Crear un usuario | Documentación de Ordering.co"
description: "Usa POST /users para crear un usuario. La operación descrita aquí es User.register.users."
canonical: https://docs.ordering.co/es/api-reference/guides/create-user/
---

# Crear un usuario

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

Usa `POST /users` para crear un usuario. La operación descrita aquí es `User.register.users`.

El esquema documentado usa el nivel de cliente `3` como valor predeterminado cuando no se solicita otro nivel, pero los roles permitidos dependen de la persona autenticada que realiza la solicitud y de la configuración de registro del proyecto. No infieras que solo los administradores pueden crear cualquier rol distinto del de cliente.

Un registro estándar requiere datos de contacto y contraseña conforme al esquema actual. Los flujos privilegiados pueden aceptar `email` o `cellphone` y crear un usuario sin contraseña para que complete sus credenciales más tarde. La configuración del proyecto también puede habilitar flujos de registro de negocio, repartidor o profesional.

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

El ejemplo es sintético.

## Ejemplo de SDK heredado

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

Confirma el paquete y la versión del SDK antes de usar este helper. Para el contexto de roles y campos, consulta [Modelo de usuario](https://docs.ordering.co/es/api-reference/guides/users-model/).

## Referencia de OpenAPI

**Operación:** `POST /users`

**Campos del cuerpo de la solicitud**

| Nombre               | Tipo    | Obligatorio |
| -------------------- | ------- | ----------- |
| `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          |

**Respuestas**

| Código | Descripción                                                                                                                                                                                                                                                                        |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | Envelope de éxito. `result` es la instancia serializada de User ($fillable menos $hidden).                                                                                                                                                                                         |
| 400    | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código.                                                                                                                                                                                     |
| 401    | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa.                                                                                                             |
| 404    | Respuesta vacía: la versión de API solicitada no está admitida.                                                                                                                                                                                                                    |
| 429    | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key.                                                                                                                       |
| 500    | Respuesta de error: falló la búsqueda o inicialización del proyecto.                                                                                                                                                                                                               |
| 503    | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on\_error = closed (cabecera Retry-After: 1). |

[Abrir esta operación en la Referencia de la API](https://docs.ordering.co/es/api-reference/#tag/users/POST/users)