# Create an Item

Endpoint: POST /api/v1/items
Version: 1.0.0

## Header parameters:

  - `Accept` (string)
    e.g. application/json
    Example: "application/json"

  - `Authorization` (string)
    e.g. Bearer
    Example: "Bearer <Enter Secret Key Here>"

## Request fields (application/json):

  - `id` (number)
    ID of the instance

  - `name` (string, required)
    Name of item

  - `price` (number)
    Price of an item

  - `quantity` (number)
    Quantity of an item

  - `min_quantity` (number)
    Minimal quantity of an item

  - `notes` (string)
    Item notes

  - `parent_id` (string)
    ID of parent folder

  - `type` (string, required)
    Type of item ( folder | item )

  - `sid` (string)
    Sortly system ID of the item

  - `label_url` (string)
    QR url OR barcode value

  - `label_url_type` (string)
    QR OR barcode type.

Allowed values:
[
    org.gs1.UPC-E,
    org.iso.Code39,
    org.iso.Code39Mod43,
    org.gs1.EAN-13,
    org.gs1.EAN-8,
    com.intermec.Code93,
    org.iso.Code128,
    org.iso.PDF417,
    org.iso.Aztec,
    org.iso.QRCode,
    org.ansi.Interleaved2of5,
    org.iso.DataMatrix,
    com.sortly.textEntry
]

  - `label_url_extra` (string)
    QR url OR barcode value

  - `label_url_extra_type` (string)
    QR OR barcode type.

Allowed values:
[
    org.gs1.UPC-E,
    org.iso.Code39,
    org.iso.Code39Mod43,
    org.gs1.EAN-13,
    org.gs1.EAN-8,
    com.intermec.Code93,
    org.iso.Code128,
    org.iso.PDF417,
    org.iso.Aztec,
    org.iso.QRCode,
    org.ansi.Interleaved2of5,
    org.iso.DataMatrix,
    com.sortly.textEntry
]

  - `tags` (array)
    List of Item tags' names

  - `custom_attribute_values` (array)
    List of Custom Fields

  - `photo_ids` (array)
    List of photo ids

  - `photos` (array)
    Could be one of:

  - `measured_quantity` (object)

  - `measured_quantity.value` (number)
    Value of items measure

  - `measured_quantity.type` (string)
    Type of units of measure.

Allowed values:
[
    weight
    length
    volume
    count
]

  - `measured_quantity.name` (string)
    Name of units of measure.

Allowed values for:

- weight: [lbs g kg oz];

- length: [yd cm ft in m];

- volume: [gal ml l ft3 in3 ft2 in2];

- count: [units].

  - `measured_quantity.scale` (number)
    Scale of value (up to 4)

  - `option_value_ids` (array)
    ID of option of attribute in Item Variant Group for Item. Required if populated item_group_id. See [Item Groups](reference/0/item-variants-groups)

  - `item_group_id` (string)
    ID Item Variant Group for Item. Required if populated option_value_ids. See [Item Groups](reference/0/item-variants-groups)

## Response 200 fields (application/json):

  - `data` (object)

  - `data.id` (number)

  - `data.name` (string)

  - `data.price` (number)

  - `data.quantity` (number)

  - `data.min_quantity` (number)

  - `data.notes` (string)

  - `data.type` (string)

  - `data.parent_id` (number)

  - `data.created_at` (string)

  - `data.updated_at` (string)

  - `data.sid` (string)

  - `data.label_url` (string)

  - `data.label_url_type` (string)

  - `data.label_url_extra` (string)

  - `data.label_url_extra_type` (string)

  - `data.tag_names` (array)

  - `data.tags` (array)

  - `data.photos` (array)

  - `data.photos.url` (string, required)

  - `data.custom_attribute_values` (array)

  - `data.custom_attribute_values.custom_attribute_id` (number)

  - `data.custom_attribute_values.custom_attribute_name` (string)

  - `data.custom_attribute_values.value` (string)

  - `data.measured_quantity` (object)

  - `data.measured_quantity.scale` (number)

  - `data.option_value_ids` (array)

  - `data.item_group_id` (string)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)