---
title: "Create a new customs item"
method: POST
path: "/customs/items"
tags: ["Customs Items"]
---

# Create a new customs item

`POST /customs/items`

Creates a new customs item object.

## Headers

- `SHIPPO-API-VERSION` string

## Request body

- CustomsItemCreateRequest
  - `description` string, required — Text description of your item.
  - `eccn_ear99` string — Export Control Classification Number, required on some exports from the United States.
  - `mass_unit` 'g' | 'kg' | 'lb' | 'oz', required — The unit used for weight.
  - `metadata` string — A string of up to 100 characters that can be filled with any additional information you want to attach to the object.
  - `net_weight` string, required — Total weight of this item, i.e. quantity * weight per item.
  - `origin_country` string, required — Country of origin of the item. Example: `US` or `DE`. All accepted values can be found on the [Official ISO Website](http://www.iso.org/).
  - `quantity` integer, required — Quantity of this item in the shipment you send. Must be greater than 0.
  - `sku_code` string — SKU code of the item, which is required by some carriers.
  - `hs_code` string — HS code of the item, which is required by some carriers. If `tariff_number` is not provided, `hs_code` will be used. If both `hs_code` and `tariff_number` are provided, `tariff_number` will be used. 50 character limit.
  - `tariff_number` string — The tariff number of the item. If `tariff_number` is not provided, `hs_code` will be used. If both `hs_code` and `tariff_number` are provided, `tariff_number` will be used. 12 character limit.
  - `value_amount` string, required — Total value of this item, i.e. quantity * value per item.
  - `value_currency` string, required — Currency used for value_amount. The [official ISO 4217](http://www.xe.com/iso4217.php) currency codes are used, e.g. `USD` or `EUR`.

## Response `201`

Customs item

- CustomsItem
  - `description` string, required — Text description of your item.
  - `eccn_ear99` string — Export Control Classification Number, required on some exports from the United States.
  - `mass_unit` 'g' | 'kg' | 'lb' | 'oz', required — The unit used for weight.
  - `metadata` string — A string of up to 100 characters that can be filled with any additional information you want to attach to the object.
  - `net_weight` string, required — Total weight of this item, i.e. quantity * weight per item.
  - `origin_country` string, required — Country of origin of the item. Example: `US` or `DE`. All accepted values can be found on the [Official ISO Website](http://www.iso.org/).
  - `quantity` integer, required — Quantity of this item in the shipment you send. Must be greater than 0.
  - `sku_code` string — SKU code of the item, which is required by some carriers.
  - `hs_code` string — HS code of the item, which is required by some carriers. If `tariff_number` is not provided, `hs_code` will be used. If both `hs_code` and `tariff_number` are provided, `tariff_number` will be used. 50 character limit.
  - `tariff_number` string — The tariff number of the item. If `tariff_number` is not provided, `hs_code` will be used. If both `hs_code` and `tariff_number` are provided, `tariff_number` will be used. 12 character limit.
  - `value_amount` string, required — Total value of this item, i.e. quantity * value per item.
  - `value_currency` string, required — Currency used for value_amount. The [official ISO 4217](http://www.xe.com/iso4217.php) currency codes are used, e.g. `USD` or `EUR`.
  - `object_created` string, date-time — Date and time of object creation.
  - `object_id` string — Unique identifier of the given object.
  - `object_owner` string — Username of the user who created the object.
  - `object_state` 'VALID' | 'INVALID' — Indicates the validity of the enclosing object
  - `object_updated` string, date-time — Date and time of last object update.
  - `test` boolean — Indicates whether the object has been created in test mode.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/goshippo/apis/shippo-external-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-external-api/revisions/13280a44853c/schema)