> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Crear un usuario > Utiliza este endpoint para crear el acceso de un usuario y asignarlo a un grupo de permisos en un solo paso. ## OpenAPI ````yaml es/openapi/v3-current/AM-identity.yaml post /v1/users openapi: 3.1.0 info: title: Plugin de identidad description: '' version: 2.4.5 servers: - url: https://identity.sandbox.lerian.net security: [] tags: - name: API de grupos - name: API de aplicaciones - name: API de usuarios - name: API de MFA - name: API de proveedores - name: API de proveedores de aplicación paths: /v1/users: post: tags: - API de usuarios summary: Crear un usuario description: >- Utiliza este endpoint para crear el acceso de un usuario y asignarlo a un grupo de permisos en un solo paso. parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UserInput' example: email: john@example.com firstName: John lastName: Doe password: Lerian@123456 username: johndoe groups: - admin-group - midaz-viewer-group responses: '201': description: >- Indica que el recurso se creó correctamente y que la operación se completó según lo esperado. content: application/json: schema: $ref: '#/components/schemas/UserResponse' example: id: 019c96a0-0c21-71f9-a487-66a1258278a1 firstName: John lastName: Doe email: john@example.com username: johndoe groups: - admin-group - midaz-viewer-group headers: {} '400': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' examples: Error0001: $ref: '#/components/examples/Error0001' Error0002: $ref: '#/components/examples/Error0002' Error0004: $ref: '#/components/examples/Error0004' Error0007: $ref: '#/components/examples/Error0007' Error0017: $ref: '#/components/examples/Error0017' Error0020: $ref: '#/components/examples/Error0020' Error0021: $ref: '#/components/examples/Error0021' Error0022: $ref: '#/components/examples/Error0022' Error0023: $ref: '#/components/examples/Error0023' Error0024: $ref: '#/components/examples/Error0024' Error0025: $ref: '#/components/examples/Error0025' Error0026: $ref: '#/components/examples/Error0026' headers: {} '500': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' examples: Error0006: $ref: '#/components/examples/Error0006' headers: {} security: - bearer: [] components: schemas: UserInput: description: Información sobre el usuario. type: object required: - email - firstName - lastName - password - username properties: email: type: string description: Dirección de correo electrónico del usuario. firstName: type: string description: Nombre del usuario. groups: description: >- Array de identificadores de los grupos de roles del usuario. Los IDs de grupos se pueden obtener mediante el endpoint List Groups. type: array items: type: string lastName: type: string description: Apellido del usuario. password: type: string description: Contraseña del usuario para la autenticación. username: type: string description: Nombre de usuario. UserResponse: description: >- Detalles de identidad de un usuario, incluida la información básica y los grupos. type: object properties: email: type: string description: Dirección de correo electrónico del usuario. firstName: type: string description: Nombre del usuario. groups: type: array items: type: string description: Lista de grupos a los que pertenece el usuario. id: type: string description: Identificador único del usuario. lastName: type: string description: Apellido del usuario. username: type: string description: Nombre de usuario único. ErrorMessage: description: Mensaje de error devuelto en la respuesta. type: object properties: code: type: string description: Identificador único y estable del error. title: type: string description: Resumen breve del problema. message: type: string description: Orientación detallada para resolver el error. examples: Error0001: summary: Missing Fields in Request value: code: IDE-0001 title: Missing Fields in Request message: Your request is missing one or more required fields. Error0002: summary: Invalid Field Type in Request value: code: IDE-0002 title: Invalid Field Type in Request message: The provided field type in the request is invalid. Error0004: summary: Unexpected Fields in the Request value: code: IDE-0004 title: Unexpected Fields in the Request message: >- The request body contains more fields than expected. Please send only the allowed fields. Error0007: summary: Bad Request value: code: IDE-0007 title: Bad Request message: The server could not understand the request due to malformed syntax. Error0017: summary: User Already Exists value: code: IDE-0017 title: User Already Exists message: >- The user already exists. Please use a different username or email and try again. Error0020: summary: Password Too Short value: code: IDE-0020 title: Password Too Short message: The password must be at least 12 characters long. Error0021: summary: Password No Uppercase value: code: IDE-0021 title: Password No Uppercase message: The password must contain at least one uppercase letter. Error0022: summary: Password No Lowercase value: code: IDE-0022 title: Password No Lowercase message: The password must contain at least one lowercase letter. Error0023: summary: Password No Digit value: code: IDE-0023 title: Password No Digit message: The password must contain at least one digit. Error0024: summary: Password No Special Char value: code: IDE-0024 title: Password No Special Char message: The password must contain at least one special character. Error0025: summary: Password Consecutive Repeated value: code: IDE-0025 title: Password Consecutive Repeated message: The password must not contain consecutive repeated characters. Error0026: summary: Password Unknown Rule value: code: IDE-0026 title: Password Unknown Rule message: Unknown password validation rule. Error0006: summary: Internal Server Error value: code: IDE-0006 title: Internal Server Error message: The server encountered an unexpected error. Please try again later. securitySchemes: bearer: type: http scheme: bearer description: El token de autorización en formato 'Bearer '. ````