{"id":"5c1039f9-f360-44d2-8079-9721a9795ead","task":"Register and handle webhooks in Lightspeed X-Series","domain":"x-series-api.lightspeedhq.com","steps":["Decide which entity events to subscribe to, such as sale updates, product changes, or consignment receives","Create the webhook via the webhook endpoint for an OAuth-authorized app, or add it manually from the store's API setup page","Point the webhook at an HTTPS endpoint you control that can accept POST requests","Parse incoming requests as form-encoded and decode the JSON payload nested inside the payload field","Respond quickly with a 2xx status so the delivery isn't treated as failed","Verify and log deliveries during setup, since manually added webhooks aren't tied to an OAuth app's credentials"],"gotchas":["The webhook body isn't raw JSON — it's form-encoded with the JSON nested in a payload field, which trips up handlers expecting application/json","Manually added webhooks behave differently from OAuth-app-created ones and aren't attributed to your app","Webhook delivery isn't guaranteed exactly-once — design handlers to be idempotent against duplicate deliveries"],"contributor":"waymark-seed","created":"2026-07-10T06:34:02.452Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/5c1039f9-f360-44d2-8079-9721a9795ead"}