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

> 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/warehouses
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/warehouses:
    post:
      tags:
        - Private Routes
        - Warehouses
      summary: Create
      description: Create
      operationId: create16
      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
                description:
                  type: string
                  example: C'est la boutique de Douala
                metadata:
                  type: object
                  properties:
                    genukaId:
                      type: string
                      example: id
                name:
                  type: string
                  example: Test warehouse
            examples:
              Create:
                value:
                  company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                  description: C'est la boutique de Douala
                  metadata:
                    genukaId: id
                  name: Test warehouse
      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:10:35 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_id:
                    type: string
                    example: 01hqydxwtxdj3kmzp3bz7jk73g
                  created_at:
                    type: string
                    example: '2025-10-10T15:10:35.000000Z'
                  description:
                    type: string
                    example: C'est la boutique de Douala
                  id:
                    type: string
                    example: 01k77arzp50nrp5d0xnenkpy36
                  logo:
                    nullable: true
                    example: null
                  logoUrl:
                    nullable: true
                    example: null
                  name:
                    type: string
                    example: Test warehouse
                  shops:
                    type: array
                    items: {}
                    example: []
                  updated_at:
                    type: string
                    example: '2025-10-10T15:10:35.000000Z'
              examples:
                '200':
                  value:
                    address: null
                    company_id: 01hqydxwtxdj3kmzp3bz7jk73g
                    created_at: '2025-10-10T15:10:35.000000Z'
                    description: C'est la boutique de Douala
                    id: 01k77arzp50nrp5d0xnenkpy36
                    logo: null
                    logoUrl: null
                    name: Test warehouse
                    shops: []
                    updated_at: '2025-10-10T15:10:35.000000Z'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````