Event · Inventory

inventory.physical.updated

A physical product quantity changed: a sale, a manual adjustment or an app.

Scopeinventory:readRead inventory availability products:readRead products and categories

Payload `data`

Every event arrives in the standard webhook envelope. These are the fields of data.

product_idinteger: Product ID.
product_kindphysical
quantityinteger: Quantity available now.

Request your endpoint receives

HTTP

POST /larm/webhooks HTTP/1.1
Host: app.example.com
Content-Type: application/json
x-larm-event: inventory.physical.updated
x-larm-event-id: 0b7c2f8e-1d3a-4c5b-9e6f-7a8b9c0d1e2f
x-larm-delivery: 2b9f6c1e-8d4a-4f30-a7e5-c1d9b8a7f604
x-larm-timestamp: 1792060982
x-larm-secret-generation: 1
x-larm-payload-version: 1
x-larm-signature: v1=5d41402abc4b2a76b9719d911017c592e1c7b0d3f6a8e2b4c9d0f1a2b3c4d5e6

JSON

{
  "app_id": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
  "data": {
    "product_id": 57,
    "product_kind": "physical",
    "quantity": 14
  },
  "id": "0b7c2f8e-1d3a-4c5b-9e6f-7a8b9c0d1e2f",
  "installation_generation": 1,
  "installation_id": "c7e4a1f2-6b3d-4e8a-9c05-1d2f3a4b5c6d",
  "occurred_at": "2026-10-15T09:13:02Z",
  "payload_version": 1,
  "resource": {
    "type": "inventory",
    "id": "57",
    "version": 12
  },
  "store_id": "5b1d7a62-0c4e-4f38-9a51-2e7b3c9d8f10",
  "test": false,
  "type": "inventory.physical.updated"
}

Payload data

Payload `data`