Get started with Lightspeed Retail (X-Series) on HexaSync

This article shows you how to authorize the Lightspeed Retail (X-Series) connection to HexaSync and create the Lightspeed Retail (X-Series) Connector App. After connecting, HexaSync can get customer, product, inventory, outlet, and sales data from Lightspeed. Your business can use this data to check and reconcile sales and inventory information, assess data quality, and prepare for integration with other systems.

Before you start

• A Beehexa account to access HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
• A Lightspeed Retail (X-Series) account with permission to approve apps, usually the store owner or an Admin.
• The Store URL of the Lightspeed store, which is the part before .retail.lightspeed.app in the store address.

Example: If the store address is acme-retail.retail.lightspeed.app, the Store URL to enter is acme-retail.

Part 1: Authorize the Lightspeed Retail (X-Series) connection on HexaSync

Step 1: Sign in to HexaSync

• Sign in with your Beehexa account at HexaSync Automation Engine.

Step 2: Start connecting Lightspeed Retail (X-Series)

1. Open the Lightspeed Retail (X-Series) authentication page on HexaSync.
2. On the Check connection details screen, select Connect under Lightspeed Retail (X-Series).

Step 3: Confirm the HexaSync app

1. Select Continue to proceed with the HexaSync Lightspeed Retail (X-Series) app, which is already selected.
2. HexaSync takes you to the Lightspeed sign-in page.

Step 4: Sign in to Lightspeed Retail (X-Series)

1. Enter the Store URL of the Lightspeed store, then select Next.
2. Enter the Username and Password of the Lightspeed account, then select Log in.

Note: If you are already signed in to Lightspeed, the system may show the message You’re already signed in to with the store name. Check the store name before you select it to continue. If it is not the store you want to connect, enter the Store URL of the other store.

Step 5: Authorize HexaSync to access Lightspeed

1. Check the access permissions that Lightspeed shows.
2. Select Approve installation to authorize HexaSync.
3. After you authorize successfully, Lightspeed takes you back to HexaSync.

Note: If you select Decline installation, HexaSync shows the message The provider did not grant the authorization. Select Resume the installation to do the authorization step again.

Step 6: Create the Lightspeed Retail (X-Series) Connector App

1. Check that Lightspeed Retail (X-Series) has the Connected status.
2. Select Create Lightspeed Retail (X-Series) Connector.
3. Check the suggested name, edit it if needed, then select Continue. Example: [acme-retail] Lightspeed Retail (X-Series) Connector.

When you are done, open Connector Apps to find and check the Connector App you just created.

Note: Completing this step means that HexaSync has been authorized to access Lightspeed and the Connector App has been created. It does not mean that all data has been retrieved successfully.

Part 2: Re-authorize the Lightspeed Retail (X-Series) connection on HexaSync

Re-authorize when HexaSync can no longer access Lightspeed data, for example:

• The HexaSync app was removed from the Lightspeed store.
• The Connector App reports a connection error with Lightspeed.

Step 1: Open the Connector App Settings

1. Open Connector Apps and select the existing Lightspeed Retail (X-Series) Connector App.
2. Select Settings in the left menu.
3. Under Integration Apps & Credentials, select Re-authorize on the Lightspeed Retail (X-Series) row.

Cannot see the Re-authorize button? Contact the person who created the Connector App or someone with the Profile Admin role to do this.

Step 2: Sign in and re-authorize access

• Do the remaining steps the same way as the first connection (Step 3 to Step 5 of Part 1), using the same Lightspeed store that is linked to the existing Connector App.

Note: You do not need to create a new Connector App when you re-authorize.

Step 3: Check the connection status

• Check that Lightspeed Retail (X-Series) has the Connected status on the Settings page after you re-authorize.
• The data that was already copied stays unchanged. The next data refresh, within 15 minutes, uses the new connection.

Part 3: Common errors and how to fix them

For other errors, send a screenshot of the error message to support@beehexa.com for support.

Frequently asked questions

What is the Store URL of Lightspeed Retail (X-Series)?

The Store URL is the store identifier that comes before .retail.lightspeed.app in your Lightspeed address. For example, for the address acme-retail.retail.lightspeed.app, you only need to enter acme-retail in the Store URL field when you sign in.

Who can authorize the Lightspeed connection to HexaSync?

You need a Lightspeed account with permission to approve apps, usually the store owner or an Admin. This account is used to sign in to Lightspeed and select Approve installation during the connection.

I already signed in to Lightspeed. Do I need to sign in again?

Not necessarily. If Lightspeed shows You’re already signed in to with the store name, you can select that store to continue. Check the store name before you confirm. If you want to connect a different store, enter its Store URL.

After the Connector App is created, does HexaSync automatically edit data in Lightspeed?

No. In this connection process, HexaSync only reads data and does not automatically edit customers, products, or orders in Lightspeed. Creating the Connector App also does not mean that a data sync process with another system is fully configured.

If the Lightspeed connection is interrupted, do I need to create a new Connector App?

No. You can re-authorize the existing Connector App: open the Connector App, go to Settings, then select Re-authorize under Integration Apps & Credentials. After you re-authorize successfully, the connection shows Connected and the data that was already copied stays unchanged.