> ## Documentation Index > Fetch the complete documentation index at: https://docsnewgen.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Crear un usuario > Crea un nuevo usuario dentro del alcance de la organización. ## OpenAPI ````yaml /api-reference/openapi-v2.json post /v2/organizations/{organization_id}/users openapi: 3.0.3 info: title: API Pública Portal version: 2.0.0 description: API pública REST para Portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Actividad digital description: Creación de grupos de procesos core por organización - name: Roles description: Endpoint de creaciÓn de roles de organización - name: Usuarios description: Endpoint de creación de usuarios de organización - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organización - name: Aplicaciones instaladas description: Endpoint de detalle de aplicación instalada de la organización - name: Autenticación description: Endpoints de autenticación y contexto de sesión - name: Microservicios description: Detalle de microservicios por organización - name: Operaciones description: Consulta de detalle de operaciones por organización - name: Organización description: Operaciones de organización - name: Objetivos de política de parches description: Endpoints de gestión de objetivos de política de parches - name: Configuraciones de producto description: Endpoints de gestión de configuraciones de producto - name: Grupos de reporte description: Operaciones sobre grupos de reporte - name: Sesiones description: Endpoint de detalle de sesión de la organización - name: Tenants description: Endpoints de gestión de tenants paths: /v2/organizations/{organization_id}/users: post: tags: - Usuarios summary: Crear un usuario description: Crea un nuevo usuario dentro del alcance de la organización. operationId: create_user parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización. example: 507f1f77bcf86cd799439011 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateUserRequestV2' examples: standard_user: summary: Crear un usuario estandar value: name: Ana surname: López email: ana.lopez@example.com language: en-EN role_id: 64f0c2a1b2d3e4f5060708aa department: Support email_login_enabled: false email_login_user: summary: >- Crear un usuario con inicio de sesión por correo electrónico habilitado value: name: Diego surname: Santos email: diego.santos@example.com language: es-ES role_id: 64f0c2a1b2d3e4f5060708ab email_login_enabled: true responses: '201': description: Usuario creado correctamente. content: application/json: schema: $ref: '#/components/schemas/UserByIdV2' examples: created: summary: Usuario creado value: id: 64f0c2a1b2d3e4f506070801 organization_id: 507f1f77bcf86cd799439011 name: Ana surname: López email: ana.lopez@example.com language: en-EN created_at: '2026-06-22T16:00:00.000Z' department: Support role_id: 64f0c2a1b2d3e4f5060708aa created_by: 64f0c2a1b2d3e4f5060708bb email_login_enabled: false '400': description: Carga útil de solicitud no válida. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_email: summary: El formato del correo electrónico no es válido value: error: message: Cuerpo de solicitud no válido code: bad_request details: email debe ser una dirección válida '401': description: No autorizado o la organización no es accesible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallo de acceso a la organización value: error: message: No autorizado code: unauthorized '404': description: >- No se encontró el recurso referenciado dentro del alcance de la organización autorizada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: user_role_not_found: summary: No se encontró el rol de usuario value: error: message: Rol de usuario no encontrado code: not_found '409': description: La solicitud entra en conflicto con un recurso existente. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: email_already_exists: summary: El correo electrónico ya existe value: error: message: El correo electrónico ya existe code: conflict details: email ya está registrado '500': description: Error interno del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallo no controlado value: error: message: Error interno del servidor code: internal_error components: schemas: CreateUserRequestV2: type: object properties: name: type: string minLength: 1 maxLength: 120 description: Nombre del usuario. surname: type: string minLength: 1 maxLength: 120 description: Apellido del usuario. email: type: string format: email description: Dirección de correo electrónico del usuario. language: type: string enum: - en-EN - es-ES - pt-BR - ca-ES - eu-ES description: Codigo de idioma preferido. role_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del rol asignado al usuario. department: type: string nullable: true description: Departamento del usuario. email_login_enabled: type: boolean nullable: true description: >- Si el inicio de sesión por correo electrónico está habilitado para el usuario. required: - name - surname - email - language - role_id UserByIdV2: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del usuario. organization_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización asociado al usuario. name: type: string description: Nombre del usuario. surname: type: string description: Apellido del usuario. email: type: string format: email description: Dirección de correo electrónico del usuario. language: type: string enum: - en-EN - es-ES - pt-BR - ca-ES - eu-ES description: Codigo de idioma preferido para el usuario. created_at: type: string description: Fecha de creación en formato ISO 8601. department: type: string nullable: true description: Departamento del usuario. role_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del rol asignado al usuario. created_by: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del usuario que creo el registro del usuario. email_login_enabled: type: boolean nullable: true description: >- Indica si el inicio de sesión por correo electrónico está habilitado para el usuario. required: - id - name - surname - email - language - created_at ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````