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": "8531e39f-4626-46aa-94bc-1689ec5d71be",
  "event": "inventory.low_stock",
  "created": "2026-06-12T02:18:48.251Z",
  "data": {
    "productTitle": "Cotton Iro & Buba",
    "variantLabel": "S · Navy",
    "stock": 4,
    "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.