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

# Inventory created

`POST inventory.created` (webhook)

When an Inventory Item is created.

## Payload

- union
  - WmsInventoryCreatedFullWebhook
    - `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.created', required
    - `integration_name` string, required
    - `integration_type` string, required
  - WmsInventoryCreatedTruncatedWebhook
    - `connection_id` string, required
    - `data` WmsInventoryCreatedTruncatedData, required
      - `id` string: The record this event is about. Absent on connection webhooks, which carry dates rather than a row.
    - `event_type` 'inventory.created', required
    - `integration_name` string, required
    - `integration_type` string, 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)