Webhook

Inventory quantities changed

​

Fires when the quantity on one or more of your inventory lines changes — after a sale, an order cancellation, an import, a direct edit, or a listing operation. Each delivery carries up to 500 changed lines; larger change sets are split across several deliveries, each with its own eventId.

Body
required
application/json
  • data
    Type: object
    required

    The quantity changes and what caused them.

  • eventId
    Type: string
    required

    Idempotency key. Stable across retries of the same delivery; safe to dedupe on. When a change set is split across several deliveries, each delivery has its own eventId.

  • timestamp
    Type: string Format: date-time
    required

    When this webhook was emitted (ISO 8601, UTC).

  • type
    const:  
    inventory.quantity.changed
    required
Responses
  • 2XX

    Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.

Request Example for postinventory.quantity.changed
{
  "type": "inventory.quantity.changed",
  "eventId": "9c41be2f3a07d815-0",
  "timestamp": "2026-06-02T09:41:27.000Z",
  "data": {
    "reason": "order",
    "changes": [
      {
        "inventoryId": "665f3a2b1c8d4e9f7a6b5c4d",
        "customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01",
        "productId": 50212,
        "before": 4,
        "after": 3
      },
      {
        "inventoryId": "665f3a2b1c8d4e9f7a6b5c4e",
        "customId": null,
        "productId": 50213,
        "before": 12,
        "after": 10
      }
    ]
  }
}
No Body

Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.