---
title: "Create Item"
method: POST
path: "/items"
tags: ["items"]
---

# Create Item

`POST /items`

## Request

- Base URL: `https://app.zenventory.com/rest`
- URL: `https://app.zenventory.com/rest/items`
- Auth: none declared

Create a new item.

## Request body

- object
  - `sku` string, required: The item's SKU.
  - `clientId` integer: Id of the client that the item belongs to. Defaults to the user's client id.
  - `clientName` string: Name of the client that the item belongs to. Ignored if clientId is provided and is nonzero.
  - `upc` string: The item's UPC.
  - `description` string: The item's description.
  - `category` string: The item's category to be grouped by.
  - `baseUom` string: The item's base unit of measurement.
  - `unitCost` number: How much the item costs you to stock.
  - `leadTime` integer: The item's lead time.
  - `defaultEconOrder` integer: The item's default order quantity for purchase orders.
  - `orderLimit` integer: The item's order limit.
  - `rrp` number: The item's recommended retail price.
  - `price` number: How much the item is sold for.
  - `active` boolean: True if the item is active. Inactive items are hidden from most processes.
  - `kit` boolean: True if the item is a kit item made up of other items. An item cannot both be a kit and an assembly item.
  - `assembly` boolean: True if the item is stocked by combining other items together. An item cannot both be a kit and an assembly item.
  - `perishable` boolean: True if the item has an expiration date. A non-inventory or serialized item cannot also be this.
  - `trackLot` boolean: True if the item is tracked by lot numbers. A non-inventory or serialized item cannot also be this.
  - `serialized` boolean: True if the item is tracked by serial numbers. A non-inventory item cannot be serialized.
  - `nonInventory` boolean: True if the item does not have inventory. A kit or assembly cannot also be non-inventory.
  - `weight` number: The item's weight;
  - `storageLength` number: Part of the dimensions the item takes to store.
  - `storageWidth` number: Part of the dimensions the item takes to store.
  - `storageHeight` number: Part of the dimensions the item takes to store.
  - `safetyStock` integer: How much stock should be withheld when reporting stock levels to marketplace integrations.
  - `userField1` string: User defined field for the item.
  - `userField2` string: User defined field for the item.
  - `userField3` string: User defined field for the item.
  - `userField4` string: User defined field for the item.
  - `userField5` string: User defined field for the item.
  - `userField6` string, date-time: User defined field for the item.
  - `notes` string: Notes for the item.
  - `assignToAllWarehouses` boolean: True to assign to all warehouses on creation.
  - `assignToWarehouse` boolean: True to assign the item to a specific warehouse.
  - `warehouseId` integer: Id of the warehouse the item will be assigned to. If no warehouse parameters are given, then the user's current warehouse will be used.
  - `warehouseName` string: Name of the warehouse the item will be assigned to. Ignored if warehouseId is provided.
  - `reorderLevel` integer: Reorder level for the item's warehouse assignment.

## Response `201`

Success

- Item
  - `id` integer
  - `sku` string
  - `upc` string
  - `description` string
  - `category` string
  - `client` ClientCompact
    - `id` integer
    - `name` string
  - `baseUom` string
  - `unitCost` number
  - `leadTime` integer
  - `defaultEconOrder` integer
  - `rrp` number
  - `price` number
  - `active` boolean
  - `kit` boolean
  - `assembly` boolean
  - `perishable` boolean
  - `trackLot` boolean
  - `serialized` boolean
  - `nonInventory` boolean
  - `weight` number
  - `storageLength` number
  - `storageWidth` number
  - `storageHeight` number
  - `storageVolume` number
  - `safetyStock` integer
  - `userField1` string
  - `userField2` string
  - `userField3` string
  - `userField4` string
  - `userField5` string
  - `userField6` string, date-time
  - `createdDate` string, date-time
  - `modifiedDate` string, date-time
  - `notes` string

---

[API](https://skmtc.dev/zenventory/apis/zenventory-rest-api.md) · [All operations](https://skmtc.dev/zenventory/apis/zenventory-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zenventory/apis/zenventory-rest-api/revisions/b40aa340773b?raw)