Connect Lightspeed Retail (X-Series) to NitroMule
Updated 2026-09-15
On this page
Connect Lightspeed Retail (X-Series) with your domain prefix and a personal token so paid pending-delivery sales import into NitroMule. Rate shop, buy labels from the order, fulfill the sale, and write tracking onto the sale note.
Note
This is X-Series (mystore.retail.lightspeed.app), not Lightspeed Retail (R-Series) or Ecwid by Lightspeed. ShipStation’s Lightspeed Retail connector targets the same X-Series API.
Requirements
- A NitroMule account on a plan that includes store connections (Business)
- A Lightspeed Retail (X-Series) store with admin access
- Domain prefix (
mystoreformystore.retail.lightspeed.app) + personal token with sales, customers, products, and fulfillments access - A default ship-from address in NitroMule
Note
Only fully paid sales with a pending delivery fulfillment and a ship-to address are imported. Pickup-only and voided sales are skipped.
Connect
- Open Stores in NitroMule → Lightspeed Retail (X-Series) → Connect.
- Paste domain prefix and personal token, then Connect.
- Select Sync (or open Orders — NitroMule auto-syncs if the last sync was more than a few minutes ago).
Features
| Feature | What it does |
|---|---|
| Order import | Pulls paid pending-delivery sales into Incomplete |
| Order details | Invoice #, payment method, discounts, sale notes, line SKUs / weights |
| Auto-sync | When you open Orders, syncs if the last sync is older than about 3 minutes |
| Rate shop / labels | Same NitroMule label flow as other stores |
| Tracking write-back | Marks the sale fulfilled and appends tracking to the X-Series sale note (X-Series has no dedicated tracking field — same as ShipStation) |
Important
Create labels from the imported order, not as a one-off Get Label shipment, so tracking can write back to Lightspeed.
Troubleshooting
- No orders after Sync: Confirm the sale is fully paid, has a delivery fulfillment still pending, and the customer has a shipping address.
- Tracking not in X-Series: Open the order’s Lightspeed X-Series details panel. Fulfill may succeed while the note update fails — the error is shown there. Tracking still exists in NitroMule.
- Disconnect: Use Disconnect on the Stores card, then Connect again with a new token if needed.