xclade
Admin APIInventory items

Create Inventory Item

Create an inventory item.

POST
/admin/inventory-items
AuthorizationBearer <token>

In: header

Query Parameters

fields?string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.

Request Body

application/json

sku?string

The inventory item's SKU.

hs_code?string

The inventory item's HS code.

weight?number

The inventory item's weight.

length?number

The inventory item's length.

height?number

The inventory item's height.

width?number

The inventory item's width.

origin_country?string

The inventory item's origin country.

mid_code?string

The inventory item's mid code.

material?string

The inventory item's material.

title?string

The inventory item's title.

description?string

The description of the variant associated with the inventory item.

requires_shipping?boolean

Whether the item requires shipping.

thumbnail?string

The inventory item's thumbnail.

metadata?object

The inventory item's metadata, used to store custom key-value pairs.

Response Body

application/json

application/json

text/plain

application/json

application/json

application/json

application/json

curl -X POST "https://{tenant}.api.myxclade.com/admin/inventory-items" \  -H "Content-Type: application/json" \  -d '{}'
{
  "inventory_item": {
    "id": "string",
    "sku": "string",
    "origin_country": "string",
    "hs_code": "string",
    "requires_shipping": true,
    "mid_code": "string",
    "material": "string",
    "weight": 0,
    "length": 0,
    "height": 0,
    "width": 0,
    "title": "string",
    "description": "string",
    "thumbnail": "string",
    "metadata": {},
    "location_levels": [
      {
        "id": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z",
        "inventory_item_id": "string",
        "location_id": "string",
        "stocked_quantity": 0,
        "reserved_quantity": 0,
        "incoming_quantity": 0,
        "metadata": {},
        "inventory_item": {},
        "available_quantity": 0
      }
    ]
  }
}

{
  "message": "Discount must be set to dynamic",
  "type": "not_allowed"
}

"Unauthorized"
{
  "message": "Entity with id 1 was not found",
  "type": "not_found"
}
{
  "code": "unknown_error",
  "message": "The request conflicted with another request. You may retry the request with the provided Idempotency-Key.",
  "type": "QueryRunnerAlreadyReleasedError"
}
{
  "code": "invalid_request_error",
  "message": "Discount with code TEST already exists.",
  "type": "duplicate_error"
}

{
  "code": "api_error",
  "message": "An error occured while hashing password",
  "type": "database_error"
}