---
title: "POST /v1/outlets/{outlet_id}/items"
method: POST
path: "/v1/outlets/{outlet_id}/items"
tags: ["Items"]
---

# POST /v1/outlets/{outlet_id}/items

`POST /v1/outlets/{outlet_id}/items`

Create items library. Required permissions: `library`

## Path parameters

- `outlet_id` integer, required

## Request body

- CreateItem
  - `item` object
    - `name` string — Product name
    - `image` object — POS image data
      - `url` string — Image URL after successfully upload POS image
      - `id` integer — Image ID after successfully upload POS image
      - `width` integer — Image Width (in px)
      - `height` integer — Image Height (in px)
    - `description` string — Product Description
    - `category_id` integer — Item's category id
    - `brand_id` integer — (Required if is_ecommerce true) Item's brand id
    - `is_ecommerce` boolean — (Optional) Ecommerce option provide you with ability for MOKA ORDER SELF PICKUP & DELIVERY
    - `condition` string — (Required if is_ecommerce true) Product condition. Values available are: new, used, refurbished.
    - `weight` string — (Required if is_ecommerce true) Item's weight in gr
    - `height` string — (Required if is_ecommerce true) Item's height in cm
    - `width` string — (Required if is_ecommerce true) Item's width in cm
    - `length` string — (Required if is_ecommerce true) Item's length in cm
    - `item_variants` object[]
      - `name` string — Item's color
      - `sku` string — Item stock keeping unit
      - `in_stock` integer — Item stock
      - `track_stock` boolean — Enable track item stock
      - `cogs` integer — Item cogs
      - `track_cogs` boolean — Enable track item cogs
      - `price` integer — (Required if is_sales_type_price false) Item price
      - `sales_type_items` object
        - `sales_type_id` integer — Sales type id
        - `sales_type_price` integer — Sales type price
        - `sales_type_name` string — Sales type name
    - `is_sales_type_price` boolean — Is using multiple sales type price
    - `images` object[] — Images data if using ecommerce option
      - `raw_image_id` integer — Ecommerce Image ID after successfully upload the image
      - `url` string — Ecommerce Image URL after successfully upload POS image
    - `pre_order_days` integer — (Optional) Set preorder days if there's one

## Response `200`

Items response

- object
  - `data` object
    - `total_pages` integer
    - `total_count` integer
    - `item` object[]
      - `active_modifiers` Modifier[]
        - `id` integer
        - `business_id` integer
        - `name` string
        - `is_deleted` boolean
        - `created_at` string
        - `updated_at` string
        - `outlet_id` integer
        - `guid` string
        - `uniq_id` string
        - `synchronized_at` string
      - `item_variants` ItemVariant[]
        - `id` integer
        - `name` string
        - `sku` string
        - `price` integer
        - `in_stock` integer
        - `stock_alert` integer
        - `position` integer
        - `item_id` integer
        - `is_deleted` boolean
        - `created_at` string
        - `updated_at` string
        - `add_inventory` integer
        - `track_stock` boolean
        - `is_saved` boolean
  - `meta` MetadataProperty
    - `code` integer
    - `errors` object

## Other responses

- `400` — Bad parameter
- `401` — The access token is invalid
- `403` — Access token valid, but is denied to access the resource. Or, the merchant`s outlet is expired.
- `410` — API Deprecated
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

[API](https://skmtc.dev/mokapos/apis/moka-api.md) · [All operations](https://skmtc.dev/mokapos/apis/moka-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mokapos/moka-api/revisions/eea24d9b5965/schema)