# Connect Lightspeed to Starshipit
URL: https://support.starshipit.com/articles/202605060001-connect-lightspeed-to-starshipit
Canonical: https://support.starshipit.com/articles/202605060001-connect-lightspeed-to-starshipit
Markdown: https://support.starshipit.com/articles/202605060001-connect-lightspeed-to-starshipit.md
Updated: 2026-05-06

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Learn how to integrate Starshipit with Lightspeed so your sales import directly into Starshipit.

Integrate Starshipit with Lightspeed to import your Lightspeed sales into Starshipit. After you print a label, Starshipit can mark the sale as fulfilled in Lightspeed.

## What you need to get started

Before you get started, make sure you have:

* A Lightspeed Retail X-Series account.
* Access to your Starshipit account settings.
* Your Lightspeed domain prefix.
* A Lightspeed personal token, if you are connecting with a token instead of OAuth.

Your domain prefix is usually the first part of your Lightspeed store address. Do not include `https://` or the full website address.

## How to set up Lightspeed

You can connect Lightspeed using OAuth or your domain prefix and personal token.

1. In Starshipit, go to **Settings > Integrations**.
2. Select **Add a new integration**.
3. Select **Lightspeed**.
4. Tick **Enable Lightspeed**.
5. Enter your Lightspeed domain prefix.
6. Choose one connection option:
   * Click **Authorize OAuth** and follow the prompts.
   * Enter your Lightspeed personal token.
7. Review your import filters.
8. Tick **Write back dispatches to Lightspeed** if you want Starshipit to update fulfilled sales in Lightspeed.
9. Click **Test connection**.
10. Click **Save**.

## Create a Lightspeed personal token

Lightspeed personal tokens are only available on some Lightspeed Retail X-Series plans.

If you need to use a personal token:

1. In Lightspeed Retail POS, go to **Setup > Personal tokens**.
2. Click **Add Personal token**.
3. Enter a token name.
4. Click **Generate personal token**.
5. Copy the token and store it somewhere safe.

You will not be able to view the token again after you close the popup.

:::note
Lightspeed does not support tracking number updates for this integration. Starshipit will mark the sale as fulfilled, but the tracking number will not be sent back to Lightspeed.
:::

## Configure Lightspeed settings

| Setting | What it controls |
| --- | --- |
| **Enable Lightspeed** | Turns the Lightspeed connection on or off. |
| **Domain prefix** | Identifies your Lightspeed Retail X-Series account. Enter the part before `.retail.lightspeed.app`, without `https://`. |
| **Personal token** | An optional alternative to OAuth for authenticating the connection. |
| **State filter** | Imports only delivery sales with the state you specify. |
| **Attribute filter** | Imports only delivery sales with the attribute you specify. |
| **Legacy status filter** | Provides status matching for older Lightspeed order data. |
| **Outlet IDs** | Limits imports to specific outlets. Enter comma-separated outlet IDs. |
| **Write back dispatches to Lightspeed** | Sends dispatch details back to Lightspeed after labels are created. |

Click **Save** after changing settings. Use **Test connection** to verify the connection and review the import filters if expected sales do not appear.