# Install and Connect

## What it is

This page walks you through installing the Lightspeed X-Series app in IDC and connecting your Lightspeed account so syncs can begin.

## Before you start

* You've completed [Prerequisites](/idc/lightspeed-x-series/prerequisites.md).
* You have your Client ID, Client Secret, Refresh Token, or Personal Token ready.

## Step by step

1. In the IDC dashboard, click **Apps** in the left menu.
2. Search for **Lightspeed X-Series** and click the card.
3. Click **Install**. The app will be installed into your IDC instance.
4. Once installation completes, click **Lightspeed X-Series** again to open the app.
5. Click **Connect** (or **Credentials** if you see that label instead).
6. You'll see a form with credential fields. Choose one of the two connection modes:

{% tabs %}
{% tab title="Personal Token (recommended)" %}

1. In the **Personal Token** field, paste your Personal Token from Lightspeed X-Series Admin Settings.
2. Leave the other fields empty.
3. Click **Save**. IDC will verify the token and confirm the connection.
   {% endtab %}

{% tab title="OAuth (Client ID + Secret)" %}

1. In the **Client Id** field, enter your Client ID from Lightspeed X-Series Admin Settings.

2. In the **Client Secret** field, enter your Client Secret.

3. In the **Refresh Token** field, enter your Refresh Token (generated during OAuth authorization).

4. Leave the Personal Token field empty.

5. Click **Save**. IDC will verify the credentials and confirm the connection.
   {% endtab %}
   {% endtabs %}

6. You'll see a green confirmation message at the top of the page: "Connection saved." Your Lightspeed X-Series account is now connected.

## What success looks like

After a successful connection, you'll see:

* The app status shows **Connected** (green badge).
* The flows list appears below the credentials section, showing all available syncs (Sales Import, Stock Export, etc.).
* You can now open any flow to configure when and how data syncs.

{% hint style="info" %}
Personal Tokens do not expire unless you revoke them in Lightspeed. OAuth tokens (Refresh Token and Access Token) are automatically renewed by IDC in the background, so you do not need to manually re-authorize unless something goes wrong.
{% endhint %}

## Next step

Go to [Authentication](/idc/lightspeed-x-series/authentication.md) to understand how IDC keeps your connection secure, or open any flow in [Flows](https://github.com/In8Sync2/IDC/blob/main/lightspeed/flows/README.md) to start configuring syncs.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.in8sync.com/idc/lightspeed-x-series/prerequisites/connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.