Create Inventory Item

Adds an inventory item. A valid inventory item includes a name and code (SKU).

The code is how Order Desk matches an order line to an inventory record, so it must match the code that your orders arrive with. A mismatch here is a common reason for stock counts not being updated.

post

Authorizations

ORDERDESK-API-KEYstringRequired

Your API key, found under Store Settings on the API tab. This should be kept server-side.

ORDERDESK-STORE-IDstringRequired

Your store ID, found under Store Settings on the API tab.

Body

namestringRequiredExample: ODU Campus Hoodie

codestringRequired

Product's unique SKU. This is how Order Desk matches an order line to an inventory record, so it must match the code that your orders arrive with.

Example: ODU-HOOD-NVY-L

pricenumber · doubleOptionalExample: 19

costnumber · doubleOptional

Item cost in decimal format.

Example: 7.25

weightnumber · doubleOptional

The shipping weight of the item.

Example: 1.2

stockintegerOptional

The number of available units.

Example: 52

Other propertiesanyOptional

Other propertiesanyOptional

manufacturer_skustringOptional

The SKU used by the manufacturer. This can be used as print_sku.

Example: GT5000

locationstringOptional

Warehouse or fulfillment method responsible for the item.

Example: Main Warehouse

update_sourcestringOptional

The name of the last system to update the item's details. Setting this allows those updates to be excluded later using the update_source_not search parameter.

Example: Warehouse Sync

Responses

200

The item was created.

application/json

statusstring · enumRequired

Either success or error.

Possible values:

messagestringOptional

Describes the result. Always present when an error occurs.

execution_timestringOptional

Time taken to process the request.

Example: 0.1524 seconds

idintegerRead-onlyOptionalExample: 100009

namestringOptionalExample: ODU Campus Hoodie

codestringOptional

Product's unique SKU. This is how Order Desk matches an order line to an inventory record, so it must match the code that your orders arrive with.

Example: ODU-HOOD-NVY-L

pricenumber · doubleOptionalExample: 19

costnumber · doubleOptional

Item cost in decimal format.

Example: 7.25

weightnumber · doubleOptional

The shipping weight of the item.

Example: 1.2

stockintegerOptional

The number of available units.

Example: 52

Other propertiesanyOptional

Other propertiesanyOptional

manufacturer_skustringOptional

The SKU used by the manufacturer. This can be used as print_sku.

Example: GT5000

locationstringOptional

Warehouse or fulfillment method responsible for the item.

Example: Main Warehouse

update_sourcestringOptional

The name of the last system to update the item's details. Setting this allows those updates to be excluded later using the update_source_not search parameter.

Example: Warehouse Sync

date_addedstringOptional

Date and time in YYYY-MM-DD HH:MM:SS format. UTC unless otherwise stated.

Example: 2019-01-15 12:12:10

date_updatedstringOptional

Date and time in YYYY-MM-DD HH:MM:SS format. UTC unless otherwise stated.

Example: 2019-01-15 12:12:10

400

The request was rejected. message names the problem.

application/json

401

Authentication failed. See the Authentication guide, and note that an invalid store ID blocks your store rather than simply failing the request.

application/json

429

You are sending too fast. Wait X-Retry-After seconds. See the Rate Limits guide.

application/json

default

The request could not be completed.

application/json

post/inventory-items

curl "https://app.orderdesk.me/api/v2/inventory-items" \
  -X POST \
  -H "ORDERDESK-STORE-ID: your-store-id" \
  -H "ORDERDESK-API-KEY: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"name": "ODU Campus Hoodie", "code": "ODU-HOOD-NVY-L", "price": 19, "cost": 7.25, "weight": 1.2, "stock": 52, "manufacturer_sku": "GT5000", "location": "Main Warehouse", "variation_list": {"Size": "Large", "Color": "Red"}, "metadata": {"image": "https://example.com/odu-hoodie.jpg"}}'

{
  "status": "success",
  "message": "text",
  "execution_time": "0.1524 seconds",
  "inventory_item": {
    "id": 100009,
    "name": "ODU Campus Hoodie",
    "code": "ODU-HOOD-NVY-L",
    "price": 19,
    "cost": 7.25,
    "weight": 1.2,
    "stock": 52,
    "variation_list": {
      "Size": "Large",
      "Color": "Red"
    },
    "metadata": {
      "image": "https://example.com/odu-hoodie.jpg",
      "print_sku": "x533"
    },
    "manufacturer_sku": "GT5000",
    "location": "Main Warehouse",
    "update_source": "Warehouse Sync",
    "date_added": "2019-01-15 12:12:10",
    "date_updated": "2019-01-15 12:12:10"
  }
}