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

# Create an item

`POST /items`

Creates a new item with the specified information.

      
Items are the products and services that are sold as part of an order. They are created by a unique SKU when an order is placed, through item import, or through the API.

## Request body

- CreateItemRequest
  - `sku` string, required — SKU (stock keeping unit). Must be unique for every item, including variants.
  - `name` string, required — Name of the item.
  - `variant_code` string — Variant code of the item.
  - `barcode` string — Barcode of the item, which is used when scanning item for pick. Will be displayed as a code 128 barcode
  - `bin` string — The bin/location where the item is located in the warehouse.
  - `weight` integer — Weight of the item in grams.
  - `image_url` string — Image URL of the item that appears on the order or when picking. Will only be displayed if the URL is HTTPS.
  - `country_code_of_origin` string — ISO 3166-1 alpha-2 country code of origin.
  - `currency_code` string — ISO 4217 currency code.
  - `customs_commodity_code` string — Global tariff code for the item. Used when creating shipments that require customs declaration.
  - `customs_description` string — Customs description for the item. Used when creating shipments that require customs declaration.
  - `shop` string — Origin shop of the item.
  - `virtual` boolean — Describes if the item is a virtual item.

## Response `200`

Successful.

- Item
  - `id` integer, required — Unique identifier of the object.
  - `sku` string — SKU (stock keeping unit). Must be unique for every item, including variants.
  - `name` string — Name of the item.
  - `variant_code` string — Variant code of the item.
  - `barcode` string — Barcode of the item, which is used when scanning item for pick. Will be displayed as a code 128 barcode
  - `bin` string — The bin/location where the item is located in the warehouse.
  - `weight` integer — Weight of the item in grams.
  - `image_url` string — Image URL of the item that appears on the order or when picking. Will only be displayed if the URL is HTTPS.
  - `country_code_of_origin` string — ISO 3166-1 alpha-2 country code of origin.
  - `currency_code` string — ISO 4217 currency code.
  - `customs_commodity_code` string — Global tariff code for the item. Used when creating shipments that require customs declaration.
  - `customs_description` string — Customs description for the item. Used when creating shipments that require customs declaration.
  - `shop` string — Origin shop of the item.
  - `virtual` boolean — Describes if the item is a virtual item.
  - `country_attributes` object[], required — Country specific attributes.
    - `country_code` string, required — ISO 3166-1 alpha-2 country code.
    - `customs_commodity_code` string, nullable, required — Country specific tariff code for the item. Used when creating shipments that require customs declaration to the specified country.

## Other responses

- `401` — Unauthorized.
- `404` — Resource not found.

---

[API](https://skmtc.net/shipmondo/apis/shipmondo-api.md) · [All operations](https://skmtc.net/shipmondo/apis/shipmondo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipmondo/shipmondo-api/revisions/3b9f91693dec/schema)