Crear un usuario

API operation: Open the endpoint in Scalar

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.

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

El ejemplo es sintético.

Ejemplo de SDK heredado

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.

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