/v1.0

Crear Usuario

Crea un nuevo usuario en el sistema.

Endpoint

POST /v1/users

Autenticación

Requiere un Bearer token válido con permiso de acción createUser.

Authorization: Bearer {access_token}

Cuerpo de la solicitud

{
  "email": "usuario@ejemplo.com",
  "firstName": "Juana",
  "lastName": "García",
  "userType": "internal"
}

| Campo | Tipo | Requerido | Descripción | |-------|------|-----------|-------------| | email | string | Sí | Dirección de email del usuario (debe ser única) | | firstName | string | Sí | Nombre del usuario | | lastName | string | Sí | Apellido del usuario | | userType | "internal" \| "external" | Sí | Tipo de usuario |

Respuesta

201 Created

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "email": "usuario@ejemplo.com",
  "firstName": "Juana",
  "lastName": "García",
  "userType": "internal",
  "createdAt": "2025-01-15T10:30:00Z"
}

400 Bad Request

{
  "error": "VALIDATION_ERROR",
  "message": "El email ya está en uso"
}

403 Forbidden

{
  "error": "FORBIDDEN",
  "message": "No tienes permiso para crear usuarios"
}