> ## Documentation Index > Fetch the complete documentation index at: https://docs.genuka.com/llms.txt > Use this file to discover all available pages before exploring further. # Create user > Creates a new user under the authenticated company. This endpoint allows you to define the user’s name, email, role, and other optional metadata. Once created, the user can access the system according to their assigned permissions. ## OpenAPI ````yaml POST /2023-11/admin/users openapi: 3.0.3 info: title: Genuka V2 - API version: 1.0.0 contact: {} servers: - url: https://api-staging.genuka.com - url: https://api.genuka.com security: - bearerAuth: [] tags: - name: Public Routes - name: Pages - name: Collections - name: Shops - name: Products - name: Articles - name: Discounts - name: Blogs - name: Company - name: Review description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Private Routes - name: Authentication - name: Apps - name: Accounting - name: Addresses - name: Customer - name: Analytics - name: Articles1 - name: Availabilities - name: API Keys - name: Orders - name: Bills - name: Blogs1 - name: Calendar Events - name: Collections1 - name: Company1 - name: Customers - name: Deliveries description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Discount - name: Domains description: |- ``` json { "domain": "", "company_id": "" } ``` - name: Analytics1 - name: Orders1 - name: Payments - name: Pages1 - name: Production - name: Bill of Materials - name: Payments1 - name: Payments Methods - name: Workflows - name: New Folder - name: Wallet - name: Marketing - name: Campaigns - name: Templates - name: Products1 - name: Product Variants - name: Analytics12 - name: Services description: >- Services are "Products" that have a duration in minutes, a buffer time and a list of users able to provide the service. - name: SupplierProducts - name: Shops1 description: >- Shops are sort of subsidiary of companies. A Company can have many Shops. Each shop can have 0 or more . But all of them are properties of a Company. - name: Warehouses description: >- Warehouses are places where stocks are placed. Shop which are physical or virtual point of sales can be attached to one or many warehouses to take their products. - name: Stocks description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Review1 description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: ReviewCriterion description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: StockMovements description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Suppliers - name: Treasury Accounts description: Comptes de trésorerie - name: Users - name: Wrapped - name: Returns - name: Webhooks - name: Customer Routes - name: Authentication1 - name: Addresses1 - name: Orders12 - name: Payments12 - name: Review12 description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Developer Routes - name: Authentication12 - name: Apps1 - name: Apps Shortcut - name: Products12 description: Developer can access a company product through its app paths: /2023-11/admin/users: post: tags: - Private Routes - Users summary: Add User description: Add User operationId: addUser parameters: - name: x-company in: header schema: type: string example: '{{companyId}}' requestBody: content: application/json: examples: Add User: value: |- { "first_name": "", "last_name": "Test", "email": "test1@gmail.com", "phone": "", "role": "employee", // manager, admin "shop_ids": [ // id for shops "01k1amypzhgs7fngfx1r9d37pn" ], "permissions": [ "collections.*", "orders.view", "orders.create", "products.view", "products.create", "products.update", "products.delete", "customers.view", "customers.create", "customers.update", "suppliers.view", "warehouses.*", "suppliers.create", "suppliers.update", "expenses.view", "expenses.create", "returns.view", "returns.create", "returns.update" ], "password": "PassWord!123" } responses: '200': description: '200' headers: Cache-Control: schema: type: string example: no-cache, private Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Mon, 13 Oct 2025 09:25:32 GMT Server: schema: type: string example: nginx/1.18.0 (Ubuntu) Transfer-Encoding: schema: type: string example: chunked Vary: schema: type: string example: Origin X-RateLimit-Limit: schema: type: string example: '6000' X-RateLimit-Remaining: schema: type: string example: '5999' content: application/json: schema: type: object properties: allPermissions: type: array items: type: string example: returns.view example: - returns.view - returns.create - returns.update - orders.view - orders.create - products.view - products.create - products.update - products.delete - customers.view - customers.create - customers.update - collections.* - warehouses.* - suppliers.view - suppliers.create - suppliers.update - expenses.view - expenses.create birthdate: nullable: true example: null company_id: type: string example: 01hqydxwtxdj3kmzp3bz7jk73g created_at: type: string example: '2025-10-13T09:25:31.000000Z' deleted_at: nullable: true example: null email: type: string example: test1@gmail.com first_name: nullable: true example: null id: type: string example: 01k7ee7anat9j4bn5v71v70qck last_activity: nullable: true example: null last_login_at: nullable: true example: null last_login_ip: nullable: true example: null last_name: type: string example: Test medias: type: array items: {} example: [] metadata: nullable: true example: null name: type: string example: ' Test' opt_in: type: number example: 0 permissions: type: array items: type: string example: returns.view example: - returns.view - returns.create - returns.update - orders.view - orders.create - products.view - products.create - products.update - products.delete - customers.view - customers.create - customers.update - collections.* - warehouses.* - suppliers.view - suppliers.create - suppliers.update - expenses.view - expenses.create phone: type: string example: '' pin_enabled: type: boolean example: false role: type: string example: employee shops: type: array items: type: object properties: company_id: type: string example: 01hqydxwtxdj3kmzp3bz7jk73g created_at: type: string example: '2025-07-29T09:32:01.000000Z' currency_code: type: string example: XAF currency_name: type: string example: FCFA deleted_at: nullable: true example: null description: type: string example: >- Debitis non rerum aperiam tenetur placeat ut dignissimos. id: type: string example: 01k1amypzhgs7fngfx1r9d37pn metadata: nullable: true example: null name: type: string example: Brekke Group pivot: type: object properties: shop_id: type: string example: 01k1amypzhgs7fngfx1r9d37pn user_id: type: string example: 01k7ee7anat9j4bn5v71v70qck slug: type: string example: brekke-group updated_at: type: string example: '2025-07-29T09:32:01.000000Z' example: - company_id: 01hqydxwtxdj3kmzp3bz7jk73g created_at: '2025-07-29T09:32:01.000000Z' currency_code: XAF currency_name: FCFA deleted_at: null description: >- Debitis non rerum aperiam tenetur placeat ut dignissimos. id: 01k1amypzhgs7fngfx1r9d37pn metadata: null name: Brekke Group pivot: shop_id: 01k1amypzhgs7fngfx1r9d37pn user_id: 01k7ee7anat9j4bn5v71v70qck slug: brekke-group updated_at: '2025-07-29T09:32:01.000000Z' updated_at: type: string example: '2025-10-13T09:25:31.000000Z' examples: '200': value: allPermissions: - returns.view - returns.create - returns.update - orders.view - orders.create - products.view - products.create - products.update - products.delete - customers.view - customers.create - customers.update - collections.* - warehouses.* - suppliers.view - suppliers.create - suppliers.update - expenses.view - expenses.create birthdate: null company_id: 01hqydxwtxdj3kmzp3bz7jk73g created_at: '2025-10-13T09:25:31.000000Z' deleted_at: null email: test1@gmail.com first_name: null id: 01k7ee7anat9j4bn5v71v70qck last_activity: null last_login_at: null last_login_ip: null last_name: Test medias: [] metadata: null name: ' Test' opt_in: 0 permissions: - returns.view - returns.create - returns.update - orders.view - orders.create - products.view - products.create - products.update - products.delete - customers.view - customers.create - customers.update - collections.* - warehouses.* - suppliers.view - suppliers.create - suppliers.update - expenses.view - expenses.create phone: '' pin_enabled: false role: employee shops: - company_id: 01hqydxwtxdj3kmzp3bz7jk73g created_at: '2025-07-29T09:32:01.000000Z' currency_code: XAF currency_name: FCFA deleted_at: null description: >- Debitis non rerum aperiam tenetur placeat ut dignissimos. id: 01k1amypzhgs7fngfx1r9d37pn metadata: null name: Brekke Group pivot: shop_id: 01k1amypzhgs7fngfx1r9d37pn user_id: 01k7ee7anat9j4bn5v71v70qck slug: brekke-group updated_at: '2025-07-29T09:32:01.000000Z' updated_at: '2025-10-13T09:25:31.000000Z' components: securitySchemes: bearerAuth: type: http scheme: bearer ````