---
title: "Modify, Update inventory data"
method: POST
path: "/inventory"
tags: ["Inventory"]
---

# Modify, Update inventory data

`POST /inventory`

## Request

- Base URL: `https://api.zentail.com/v1`
- URL: `https://api.zentail.com/v1/inventory`
- Auth: API key in header `AUTHORIZATION`

This call allows updating inventory data for SKUs. If the SKU does not exist in your Zentail account, it will be created and assigned the inventory provided. This works only for warhouses that dont have an integration controlling inventory.
<br />
<Note>

Include only one of quantity, delta_quantity, or onhand_quantity in your request.
</Note>

## Request body

- InventoryPost
  - `products` InventoryItems[], required
    - `SKU` string, required: SKU value is the unique identifier for a product in Zentail.
    - `quantity` integer: Quantity of the product available for sale.
    - `delta_quantity` integer: Additional quantity of this product that is now available for sale. Adds the quantity provided to quantity currently shown in Zentail.
    - `onhand_quantity` integer: This is the quantity of the product on hand. If this quantity is provided, the quantity that is reserved for 'PENDING_PAYMENT' and 'PENDING' orders is deducted, and the rest is made available for sale.
    - `binLocation` string: Name of the Bin location, if applicable.
    - `warehouseId` integer: Unique identifer for warehouse in Zentail.
    - `warehouseUniqueId` string: The integration's unique identifier for the warehouse
  - `validAsOf` string, date-time

## Response `200`

Success

- SimpleInventoryItemWithError[]
  - `SKU` string: SKU value is the unique identifier for a product in Zentail.
  - `standardProductId` string: Depending on the type defined in standardProductIdType this field contains either the UPC, EAN, ISBN, or GTIN for this product.
  - `standardProductIdType` string: One of UPC, EAN, ISBN or GTIN.
  - `active` boolean
  - `totalAvailableQuantity` integer: This is the total quantity across all warehouses that is made available for sale on the marketplaces. This does not include stock committed or reserved for various sales orders.
  - `lastInventoryUpdateTs` string, date-time
  - `errorMessage` string: Contains error message if the inventory has not been processed successfully, else null

## Other responses

- `400`: Bad Request
- `403`: Permission Denied
- `404`: Not Found
- `500`: Zentail Error
- `503`: Zentail Error

---

[API](https://skmtc.dev/zentail/apis/zentail-api.md) - [All operations](https://skmtc.dev/zentail/apis/zentail-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zentail/apis/zentail-api/revisions/55e43cb43caf?raw)