> ## 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 usuari > Crea un nou usuari dins l'abast de l'organització. ## OpenAPI ````yaml /ca/api-reference/openapi.ca-v1.json post /v1/organizations/{organization_id}/users openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: API pública REST per al portal servers: - url: https://api.flexxible.net/ description: Portal API security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/users: post: tags: - Usuaris summary: Crear un usuari description: Crea un nou usuari dins l'abast de l'organització. 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 organització. example: 507f1f77bcf86cd799439011 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateUserRequestV1' examples: standard_user: summary: Crear un usuari estàndard value: name: Ana surname: Lopez email: ana.lopez@example.com language: en-EN role_id: 64f0c2a1b2d3e4f5060708aa department: Support email_login_enabled: false email_login_user: summary: >- Crear un usuari amb inici de sessió per correu electrònic habilitat value: name: Diego surname: Santos email: diego.santos@example.com language: es-ES role_id: 64f0c2a1b2d3e4f5060708ab email_login_enabled: true responses: '201': description: Usuari creat correctament. content: application/json: schema: $ref: '#/components/schemas/UserByIdV1' examples: created: summary: Usuari creat value: id: 64f0c2a1b2d3e4f506070801 organization_id: 507f1f77bcf86cd799439011 name: Ana surname: Lopez 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: Càrrega útil de sol·licitud no vàlida. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_email: summary: El format del correu electrònic no és vàlid value: error: message: Cuerpo de solicitud no valido code: bad_request details: email debe ser una direccion valida '401': description: No autoritzat o l'organització no és accessible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallada d'accés a l'organització value: error: message: No autorizado code: unauthorized '404': description: >- No s'ha trobat el recurs referenciat dins l'abast de l'organització autoritzada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: user_role_not_found: summary: No s'ha trobat el rol d'usuari value: error: message: Rol de usuario no encontrado code: not_found '409': description: La sol·licitud entra en conflicte amb un recurs existent. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: email_already_exists: summary: El correu electrònic ja existeix value: error: message: El correo electronico ya existe code: conflict details: email ya esta registrado '500': description: Error intern del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallada inesperada value: error: message: Error interno del servidor code: internal_error components: schemas: CreateUserRequestV1: type: object properties: name: type: string minLength: 1 maxLength: 120 description: Nom de l'usuari. surname: type: string minLength: 1 maxLength: 120 description: Cognom de l'usuari. email: type: string format: email description: Adreça de correu electrònic de l'usuari. language: type: string enum: - en-EN - es-ES - pt-BR - ca-ES - eu-ES description: Codi de llengua preferit. role_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del rol assignat a l'usuari. department: type: string nullable: true description: Departament de l'usuari. email_login_enabled: type: boolean nullable: true description: >- Si l'inici de sessió per correu electrònic està habilitat per a l'usuari. required: - name - surname - email - language - role_id UserByIdV1: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'usuari. organization_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'organització associada a l'usuari. name: type: string description: Nom de l'usuari. surname: type: string description: Cognom de l'usuari. email: type: string format: email description: Adreça de correu electrònic de l'usuari. language: type: string enum: - en-EN - es-ES - pt-BR - ca-ES - eu-ES description: Codi de llengua preferit per a l'usuari. created_at: type: string description: Data de creació en format ISO 8601. department: type: string nullable: true description: Departament de l'usuari. role_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del rol assignat a l'usuari. created_by: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'usuari que va crear el registre de l'usuari. email_login_enabled: type: boolean nullable: true description: >- Indica si l'inici de sessió per correu electrònic està habilitat per a l'usuari. 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 ````