---
title: "Inventory updated"
method: POST
path: "inventory.updated"
---

# Inventory updated

`POST inventory.updated` (webhook)

When an Inventory Item is updated.

## Payload

- union
  - WmsInventoryUpdatedFullWebhook
    - `connection_id` string, required
    - `data` WmsInventoryItemApiItemSchema, required
      - `id` string, required: The unique ID of the inventory item.
      - `warehouse_customer_id` string, nullable, required: The ID of the merchant/tenant/customer that owns the inventory item. Can be passed into the [Warehouse Customer](/api-reference/wms-api/warehouse-customers/get-item) endpoint for more details.
      - `created_date` string, date-time, required: The date the inventory item was created.
      - `updated_date` string, date-time, required: The date the inventory item was last updated.
      - `name` string, required: name
      - `sku` string, nullable, required: sku
      - `unit_cost` number, nullable, required: The cost of a single unit of the inventory item.
      - `active` boolean, required: Whether the inventory item is active.
      - `awaiting` integer, required: Inventory that the warehouse is awaiting delivery of.
      - `onhand` integer, required: The total amount of inventory in the warehouse.
      - `committed` integer, required: Inventory that is already assigned to orders.
      - `unfulfillable` integer, required: Inventory that can't be fulfilled for orders (e.g. damaged/quarantined).
      - `fulfillable` integer, required: Inventory that can be fulfilled for orders.
      - `sellable` integer, required: Inventory that is available in sales channels.
      - `substitute_skus` string[], required: A list of inventory item SKUs that can replace this item if it runs out of stock.
      - `inventory_by_warehouse_id` object, required: Inventory broken down by warehouse.
      - `lots` Lot[], required: A lot is a specific batch of inventory items that are stored together and expire together. If an item doesn't expire, it is not allocated to a lot.
        - `lot_id` string, required: Lot ID.
        - `onhand` integer, required: The total amount of inventory in the lot.
        - `expiration_date` string, date-time, nullable, required: The date that the lot expires.
        - `warehouse_id` string, nullable, required: ID of the warehouse that the lot is kept in. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.
      - `measurements` InventoryItemMeasurements, required
        - `length` number, nullable, required
        - `width` number, nullable, required
        - `height` number, nullable, required
        - `unit` 'cm' | 'in', nullable, required: The unit of measurement for the size of the inventory item.
        - `weight` number, nullable, required
        - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required: The unit of measurement for the weight of the inventory item.
      - `locations` Location[], required: A list of locations within a warehouse where the inventory item is stored.
        - `location_id` string, required: Location ID.
        - `quantity` integer, required: The total amount of inventory stored in the location.
        - `warehouse_id` string, required: ID of the warehouse that contains the location. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.
      - `external_system_url` string, nullable, required: URL link to the inventory item in the external system (WMS/Freight etc).
      - `trackstar_tags` unknown[], nullable, required: A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
        - unknown
      - `additional_fields` object, required: Integration-specific fields
      - `trackstar_created_date` string, date-time, required
      - `trackstar_updated_date` string, date-time, required
    - `event_type` 'inventory.updated', required
    - `integration_name` string, required
    - `integration_type` string, required
    - `previous_attributes` WmsInventoryUpdatedPreviousAttributes, required
      - `id` string: The unique ID of the inventory item.
      - `warehouse_customer_id` string, nullable: The ID of the merchant/tenant/customer that owns the inventory item. Can be passed into the [Warehouse Customer](/api-reference/wms-api/warehouse-customers/get-item) endpoint for more details.
      - `created_date` string, date-time: The date the inventory item was created.
      - `updated_date` string, date-time: The date the inventory item was last updated.
      - `name` string: name
      - `sku` string, nullable: sku
      - `unit_cost` number, nullable: The cost of a single unit of the inventory item.
      - `active` boolean: Whether the inventory item is active.
      - `awaiting` integer: Inventory that the warehouse is awaiting delivery of.
      - `onhand` integer: The total amount of inventory in the warehouse.
      - `committed` integer: Inventory that is already assigned to orders.
      - `unfulfillable` integer: Inventory that can't be fulfilled for orders (e.g. damaged/quarantined).
      - `fulfillable` integer: Inventory that can be fulfilled for orders.
      - `sellable` integer: Inventory that is available in sales channels.
      - `substitute_skus` string[]: A list of inventory item SKUs that can replace this item if it runs out of stock.
      - `inventory_by_warehouse_id` object: Inventory broken down by warehouse.
      - `lots` Lot[]: A lot is a specific batch of inventory items that are stored together and expire together. If an item doesn't expire, it is not allocated to a lot.
        - `lot_id` string, required: Lot ID.
        - `onhand` integer, required: The total amount of inventory in the lot.
        - `expiration_date` string, date-time, nullable, required: The date that the lot expires.
        - `warehouse_id` string, nullable, required: ID of the warehouse that the lot is kept in. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.
      - `measurements` InventoryItemMeasurements
        - `length` number, nullable, required
        - `width` number, nullable, required
        - `height` number, nullable, required
        - `unit` 'cm' | 'in', nullable, required: The unit of measurement for the size of the inventory item.
        - `weight` number, nullable, required
        - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required: The unit of measurement for the weight of the inventory item.
      - `locations` Location[]: A list of locations within a warehouse where the inventory item is stored.
        - `location_id` string, required: Location ID.
        - `quantity` integer, required: The total amount of inventory stored in the location.
        - `warehouse_id` string, required: ID of the warehouse that contains the location. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.
      - `external_system_url` string, nullable: URL link to the inventory item in the external system (WMS/Freight etc).
      - `trackstar_tags` unknown[], nullable: A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
        - unknown
      - `additional_fields` object: Integration-specific fields
      - `trackstar_created_date` string, date-time
      - `trackstar_updated_date` string, date-time
  - WmsInventoryUpdatedTruncatedWebhook
    - `connection_id` string, required
    - `data` WmsInventoryUpdatedTruncatedData, required
      - `id` string: The record this event is about. Absent on connection webhooks, which carry dates rather than a row.
    - `event_type` 'inventory.updated', required
    - `integration_name` string, required
    - `integration_type` string, required
    - `previous_attributes` WmsInventoryUpdatedTruncatedPreviousAttributes, required
    - `data_truncated` boolean, required: Always true on this shape. The event was too large to send in full, so `data` holds only the `id` and `previous_attributes` is empty.
    - `data_url` string, required: Called with your usual API key, it returns a download link for this event exactly as it would have been delivered.

## Acknowledgement `200`

Success

---

[API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [All operations](https://skmtc.dev/trackstarhq/apis/trackstar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trackstarhq/apis/trackstar-api/revisions/08647f790594?raw)