> ## 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 shop

> Creates a new shop under the authenticated company. This endpoint allows you to define a shop’s name, address, contact information, and other optional metadata. Once created, the shop will be available for product assignments, employee management, and order tracking.



## OpenAPI

````yaml POST /2023-11/admin/shops
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/shops:
    post:
      tags:
        - Private Routes
        - Shops1
      summary: Create
      description: Create
      operationId: create15
      parameters:
        - name: x-company
          in: header
          schema:
            type: string
            example: '{{companyId}}'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                company_id:
                  type: string
                  example: 01hqydxwtxdj3kmzp3bz7jk73g
                currency_code:
                  type: string
                  example: XAF
                description:
                  type: string
                  example: C'est la boutique de Douala
                metadata:
                  type: object
                  properties:
                    genukaId:
                      type: string
                      example: id
                name:
                  type: string
                  example: La boutique de test
            examples:
              Create:
                value:
                  company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                  currency_code: XAF
                  description: C'est la boutique de Douala
                  metadata:
                    genukaId: id
                  name: La boutique de test
      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: Fri, 10 Oct 2025 15:17:48 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: '5998'
          content:
            application/json:
              schema:
                type: object
                properties:
                  address:
                    nullable: true
                    example: null
                  company:
                    type: object
                    properties:
                      company_code:
                        nullable: true
                        example: null
                      created_at:
                        type: string
                        example: '2025-07-29T09:31:59.000000Z'
                      currency_code:
                        type: string
                        example: XAF
                      currency_name:
                        type: string
                        example: FCFA
                      description:
                        nullable: true
                        example: null
                      handle:
                        type: string
                        example: demo-company
                      id:
                        type: string
                        example: 01hqydxwtxdj3kmzp3bz7jk73g
                      logoUrl:
                        nullable: true
                        example: null
                      metadata:
                        type: object
                        properties:
                          payment_terms:
                            type: object
                            properties:
                              accepted_at:
                                type: string
                                example: '2025-07-30T08:57:08.517Z'
                              accepted_by:
                                type: string
                                example: 'Payton Donnelly '
                      name:
                        type: string
                        example: Demo Company
                      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
                              nullable: true
                              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
                            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
                            slug: brekke-group
                            updated_at: '2025-07-29T09:32:01.000000Z'
                          - company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                            created_at: '2025-07-29T09:32:01.000000Z'
                            currency_code: XAF
                            currency_name: FCFA
                            deleted_at: null
                            description: >-
                              Deleniti eum sit dolore quaerat sit est cumque
                              eveniet.
                            id: 01k1amyq13d2mv8y05c8ym6t7b
                            metadata: null
                            name: Champlin LLC
                            slug: champlin-llc
                            updated_at: '2025-07-29T09:32:01.000000Z'
                          - company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                            created_at: '2025-10-10T15:17:48.000000Z'
                            currency_code: XAF
                            currency_name: null
                            deleted_at: null
                            description: C'est la boutique de Douala
                            id: 01k77b674gsqhykmbfp5hn1n7a
                            metadata: null
                            name: La boutique de test
                            slug: la-boutique-de-test
                            updated_at: '2025-10-10T15:17:48.000000Z'
                          - company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                            created_at: '2025-07-29T09:32:00.000000Z'
                            currency_code: XAF
                            currency_name: FCFA
                            deleted_at: null
                            description: Perspiciatis aut quia magnam et eum modi vel.
                            id: 01k1amypyvbq2zkntkvqsma3ps
                            metadata: null
                            name: Pfeffer Ltd
                            slug: pfeffer-ltd
                            updated_at: '2025-07-29T09:32:00.000000Z'
                      type:
                        type: string
                        example: business
                      updated_at:
                        type: string
                        example: '2025-07-30T09:57:08.000000Z'
                  company_id:
                    type: string
                    example: 01hqydxwtxdj3kmzp3bz7jk73g
                  created_at:
                    type: string
                    example: '2025-10-10T15:17:48.000000Z'
                  currency_code:
                    type: string
                    example: XAF
                  currency_name:
                    nullable: true
                    example: null
                  description:
                    type: string
                    example: C'est la boutique de Douala
                  domains:
                    type: array
                    items: {}
                    example: []
                  id:
                    type: string
                    example: 01k77b674gsqhykmbfp5hn1n7a
                  logo:
                    nullable: true
                    example: null
                  logoUrl:
                    type: string
                    example: ''
                  name:
                    type: string
                    example: La boutique de test
                  updated_at:
                    type: string
                    example: '2025-10-10T15:17:48.000000Z'
                  warehouses:
                    type: array
                    items: {}
                    example: []
              examples:
                '200':
                  value:
                    address: null
                    company:
                      company_code: null
                      created_at: '2025-07-29T09:31:59.000000Z'
                      currency_code: XAF
                      currency_name: FCFA
                      description: null
                      handle: demo-company
                      id: 01hqydxwtxdj3kmzp3bz7jk73g
                      logoUrl: null
                      metadata:
                        payment_terms:
                          accepted_at: '2025-07-30T08:57:08.517Z'
                          accepted_by: 'Payton Donnelly '
                      name: Demo Company
                      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
                          slug: brekke-group
                          updated_at: '2025-07-29T09:32:01.000000Z'
                        - company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                          created_at: '2025-07-29T09:32:01.000000Z'
                          currency_code: XAF
                          currency_name: FCFA
                          deleted_at: null
                          description: >-
                            Deleniti eum sit dolore quaerat sit est cumque
                            eveniet.
                          id: 01k1amyq13d2mv8y05c8ym6t7b
                          metadata: null
                          name: Champlin LLC
                          slug: champlin-llc
                          updated_at: '2025-07-29T09:32:01.000000Z'
                        - company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                          created_at: '2025-10-10T15:17:48.000000Z'
                          currency_code: XAF
                          currency_name: null
                          deleted_at: null
                          description: C'est la boutique de Douala
                          id: 01k77b674gsqhykmbfp5hn1n7a
                          metadata: null
                          name: La boutique de test
                          slug: la-boutique-de-test
                          updated_at: '2025-10-10T15:17:48.000000Z'
                        - company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                          created_at: '2025-07-29T09:32:00.000000Z'
                          currency_code: XAF
                          currency_name: FCFA
                          deleted_at: null
                          description: Perspiciatis aut quia magnam et eum modi vel.
                          id: 01k1amypyvbq2zkntkvqsma3ps
                          metadata: null
                          name: Pfeffer Ltd
                          slug: pfeffer-ltd
                          updated_at: '2025-07-29T09:32:00.000000Z'
                      type: business
                      updated_at: '2025-07-30T09:57:08.000000Z'
                    company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                    created_at: '2025-10-10T15:17:48.000000Z'
                    currency_code: XAF
                    currency_name: null
                    description: C'est la boutique de Douala
                    domains: []
                    id: 01k77b674gsqhykmbfp5hn1n7a
                    logo: null
                    logoUrl: ''
                    name: La boutique de test
                    updated_at: '2025-10-10T15:17:48.000000Z'
                    warehouses: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````