# Create a new customs item

Creates a new customs item object.

Endpoint: POST /customs/items
Version: 2018-02-08
Security: APIKeyHeader

## Header parameters:

  - `SHIPPO-API-VERSION` (string)
    Optional string used to pick a non-default API version to use. See our API version guide.
    Example: "2018-02-08"

## Request fields (application/json):

  - `description` (string, required)
    Text description of your item.
    Example: "T-Shirt"

  - `eccn_ear99` (string)
    Export Control Classification Number, required on some exports from the United States.

  - `mass_unit` (string, required)
    The unit used for weight.
    Enum: "g", "kg", "lb", "oz"

  - `metadata` (string)
    A string of up to 100 characters that can be filled with any additional information you 
want to attach to the object.
    Example: "Order ID \"123454\""

  - `net_weight` (string, required)
    Total weight of this item, i.e. quantity * weight per item.
    Example: "5"

  - `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.

  - `quantity` (integer, required)
    Quantity of this item in the shipment you send.  Must be greater than 0.
    Example: 20

  - `sku_code` (string)
    SKU code of the item, which is required by some carriers.
    Example: "HM-123"

  - `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.
    Example: "0901.21"

  - `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.
    Example: "200"

  - `value_currency` (string, required)
    Currency used for value_amount. The official ISO 4217 
currency codes are used, e.g.  USD or EUR.
    Example: "USD"

## Response 201 fields (application/json):

  - `description` (string, required)
    Text description of your item.
    Example: "T-Shirt"

  - `eccn_ear99` (string)
    Export Control Classification Number, required on some exports from the United States.

  - `mass_unit` (string, required)
    The unit used for weight.
    Enum: "g", "kg", "lb", "oz"

  - `metadata` (string)
    A string of up to 100 characters that can be filled with any additional information you 
want to attach to the object.
    Example: "Order ID \"123454\""

  - `net_weight` (string, required)
    Total weight of this item, i.e. quantity * weight per item.
    Example: "5"

  - `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.

  - `quantity` (integer, required)
    Quantity of this item in the shipment you send.  Must be greater than 0.
    Example: 20

  - `sku_code` (string)
    SKU code of the item, which is required by some carriers.
    Example: "HM-123"

  - `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.
    Example: "0901.21"

  - `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.
    Example: "200"

  - `value_currency` (string, required)
    Currency used for value_amount. The official ISO 4217 
currency codes are used, e.g.  USD or EUR.
    Example: "USD"

  - `object_created` (string)
    Date and time of object creation.
    Example: "2014-07-17T00:49:20.631Z"

  - `object_id` (string)
    Unique identifier of the given object.
    Example: "d799c2679e644279b59fe661ac8fa488"

  - `object_owner` (string)
    Username of the user who created the object.
    Example: "shippotle@shippo.com"

  - `object_state` (string)
    Indicates the validity of the enclosing object
    Enum: "VALID", "INVALID"

  - `object_updated` (string)
    Date and time of last object update.
    Example: "2014-07-17T00:49:20.631Z"

  - `test` (boolean)
    Indicates whether the object has been created in test mode.