Sign in
Events/Catalog
inventory.low_stockBuyer-initiated

Low stock alert

A variant crossed its low-stock threshold. Useful for restock automations.

When this fires

A variant's stock dropped below its low-stock threshold. Fires once per crossing — not on every sale below the line.

High frequency
This event is buyer-initiated, which means it can fire at checkout-traffic volume during busy periods. Make sure your handler responds in under ten seconds; queue any heavy work.

Sample payload

This is the exact envelope shape we POST to your endpoint — outer wrapper plus the per-event data payload. Field values are randomised on each render so you see the general shape, not a fixed example.

json
{
  "id": "c255334c-98c6-4727-a35d-63ff344d9d55",
  "event": "inventory.low_stock",
  "created": "2026-06-12T15:00:35.822Z",
  "data": {
    "productTitle": "Adire Tunic Dress",
    "variantLabel": "M · Navy",
    "stock": 3,
    "threshold": 5
  }
}

Use cases

  • Trigger an automatic restock PO with your supplier.
  • Alert the merchant on Slack / WhatsApp before they sell out.
  • Pull underperforming SKUs out of paid ads so you don't pay for a sold-out click.

Subscribe in the dashboard

To start receiving this event, add it to a webhook's subscription list in Developers → Webhooks. Wildcard subscriptions ( inventory.*) work too — see the webhooks guide for the matching rules.