---
title: "Create an item"
method: POST
path: "/items"
tags: ["Items"]
---

# Create an item

`POST /items`

Create an item

## Request body

- object
  - `item_class_code` string, required — The item class code of the item. <br>Refer to the [DigiTax Kenya eTIMS Item Classification Code list](https://ke.docs.digitax.tech/docs/items-item-classification-table) for more information.
  - `item_type_code` string, required — The item type code of the item. <br>Refer to the [DigiTax Kenya eTIMS Item Type code list](https://ke.docs.digitax.tech/docs/item-attributes-items#item-type-codes) for more information.
  - `item_name` string, required — The name of the item
  - `origin_nation_code` string, required — The country of origin code of the item. <br>Refer to the [DigiTax Kenya eTIMS Country Codes list](https://ke.docs.digitax.tech/docs/item-attributes-items#country-codes) for more information.
  - `package_unit_code` string, required — The package unit code of the item. <br>Refer to the [DigiTax Kenya eTIMS Package Unit Codes list](https://ke.docs.digitax.tech/docs/item-attributes-items#package-unit-codes) for more information.
  - `quantity_unit_code` string, required — The quantity unit code of the item. <br>Refer to the [DigiTax Kenya eTIMS Quantity Unit Codes list](https://ke.docs.digitax.tech/docs/item-attributes-items#quantity-unit-codes) for more information.
  - `tax_type_code` string, required — The tax type code of the item. <br>Refer to the [DigiTax Kenya eTIMS Tax Type Codes list](https://ke.docs.digitax.tech/docs/item-attributes-items#taxation-type-codes) for more information.
  - `default_unit_price` number, required — The default price of the item
  - `stock_quantity` number — The starting stock quantity of the item.
  - `callback_url` string — The callback url to call when we have new information about the item, usually after syncing with eTIMS
  - `item_bar_code` string — The bar code of the item. <br>EAN-13 barcodes are recommended, but not required. <br>**Ideally set your internal item ID here**. It comes in handy during reconciliation when you are comparing data reports between DigiTax and your system.
  - `levies` string[]

## Response `201`

Success

- Item
  - `id` string, required — Item ID in DigiTax
  - `item_class_code` string, required — The item class code of the item. <br>Refer to the [DigiTax Kenya eTIMS Item Classification Code list](https://ke.docs.digitax.tech/docs/items-item-classification-table) for more information.
  - `item_type_code` string, required — The item type code of the item
  - `item_name` string, required — The name of the item
  - `origin_nation_code` string, required — The country of origin code of the item
  - `package_unit_code` string, required — The package unit code of the item
  - `quantity_unit_code` string, required — The quantity unit code of the item
  - `tax_type_code` string, required — The tax type code of the item
  - `default_unit_price` number, required — The default price of the item
  - `etims_item_code` string, required — The eTIMS item code of the item
  - `is_stock_item` boolean, required — Indicates whether the item is a stock item or not. Can either be "false" or "true"
  - `stock_quantity` number, required — The quantity of items in stock
  - `active` boolean, required — Indicates whether the item is active or not
  - `status` 'PENDING' | 'FAILED' | 'COMPLETE' — sync status against eTIMS
  - `item_bar_code` string — The bar code or unique product code(UPC) of the item
  - `levies` string[]

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/digitax/apis/digitax-kenya-api-endpoints.md) · [All operations](https://skmtc.net/digitax/apis/digitax-kenya-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitax/digitax-kenya-api-endpoints/revisions/1fc0cdf61f70/schema)