Webhooks
Inventory Change

Inventory Change

This webhook is triggered whenever the On Hand quantity changes. Unlike the Inventory Update webhook, which reports the current inventory levels after a change occurs, this webhook is change-centric: it reports the delta itself. The payload includes how much the On Hand quantity changed, the previous and new values, and the reason and source of the change, allowing consumers to understand not just what the inventory is now, but why and how it changed

Webhook Body:

{
  "webhook_type": "Inventory Change",
  "account_uuid": "QWNjb3VudDo2Mzg5OA==",
  "account_id": 18963,
  "warehouse_id": 76733,
  "warehouse_uuid": "V2FyZWhvdXNlOjc2NzMz",
  "user_id": 489254,
  "user_uuid": "VXNlcjoxNTg4MjY=",
  "sku": "LOT01",
  "quantity": 10,
  "old_quantity": 0,
  "location_name": "AA-05-01-01",
  "previous_on_hand": 110,
  "timestamp": "2025-02-03 13:19:30", 
  "reason": "Change from the product page via the ShipHero Web Dashboard.",
  "source": "manual",
  "lot_id": 114475,
  "lot_uuid": "TG90OjExNDQ3NQ==",
  "lot_expiration": "2025-03-25"
}

Info

  • old_quantity includes the bin previous inventory level (sellable or not sellable)
  • previous_on_hand reports warehouse level on-hand only inventory.

Response:

{
  "code": "200",
  "Message": "Success"
}
Inventory UpdateShipment Update