Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Lightspeed Retail X-Series connector page.How Lightspeed webhooks are set up
StackOne creates and manages the Lightspeed webhook subscriptions automatically. When you enable an event in StackOne, StackOne registers one webhook for that event type in the connected store, and deletes it again when the event is turned off or the account is disconnected. There is nothing to configure in Lightspeed and no URL to paste.
Select the webhooks scope
StackOne creates and deletes the subscriptions through the Lightspeed API, which needs the webhooks scope. Make sure webhooks is among the scopes selected in the StackOne Connector profile before the account is connected, or creating the subscription fails.
Enable the events you need
Enable the Lightspeed events you want in StackOne. Each enabled event gets its own subscription, and events arriving from the store are matched to the linked account by its store subdomain.
Available webhook events
The following Lightspeed events can be enabled. Only events enabled in StackOne are subscribed, so Lightspeed does not deliver the others.
Product and inventory events
Events related to the product catalog and stock levels.
- Product Updated (
product.update) — Fired when product details change, such as name, description, SKU, price book, brand, supplier or tax - Inventory Updated (
inventory.update) — Fired when inventory quantities change through sales, adjustments or consignments. Only inventory-tracked products trigger it
Sale events
Events related to sales.
- Sale Updated (
sale.update) — Fired when a sale is created or modified. Layby and account sales can fire it more than once
Customer events
Events related to customer records.
- Customer Updated (
customer.update) — Fired when a customer is created, modified or deleted, including account balance changes
Consignment events
Events related to stock orders, transfers and stocktakes.
- Consignment Sent (
consignment.send) — Fired when consigned products are dispatched to their destination (stock transfers only) - Consignment Received (
consignment.receive) — Fired when consigned items are received into stock through a supplier order, stock transfer or stocktake
Register events
Events related to register sessions.
- Register Closure Created (
register_closure.create) — Fired each time a register session is closed and reconciled
Delivery format
Details of how Lightspeed delivers events to StackOne.
One event per request
Each request carries a single event. The body names the event in type and the store in domain_prefix, and carries the changed record in payload as a JSON-encoded string. StackOne routes each delivery to the matching event and returns HTTP 200 so Lightspeed does not retry.