> ## Documentation Index
> Fetch the complete documentation index at: https://docs.indic8.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Lemon Squeezy Setup Guide

> Step-by-step guide to connect Lemon Squeezy API Keys, Store Orders, and Webhooks to Indic8.

Connect Lemon Squeezy to track Merchant of Record sales, global sales tax deductions, license keys, and recurring subscriptions.

## What You Need to Connect

| Credential                 | Where to find it in Lemon Squeezy | Description                                                           |
| :------------------------- | :-------------------------------- | :-------------------------------------------------------------------- |
| **Lemon Squeezy API Key**  | Settings > API                    | Read-only API key to sync stores, orders, products, and subscriptions |
| **Webhook Signing Secret** | Settings > Webhooks               | Verifies real-time transaction event deliveries                       |

***

## Part 1: Generate a Lemon Squeezy API Key

<Steps>
  <Step title="Open Lemon Squeezy Settings">
    1. Log in to your [Lemon Squeezy Dashboard](https://app.lemonsqueezy.com).
    2. In the left navigation bar, click **Settings**.
    3. Under the **Developers** section, click **API**.
  </Step>

  <Step title="Create New API Key">
    1. Click the purple **+** button in the top right.
    2. In the **Name** input, enter: `Indic8 Analytics Sync`.
    3. Click **Create API Key**.
    4. Copy the newly generated key string (starts with `eyJ...`).
  </Step>
</Steps>

***

## Part 2: Connect Key in Indic8

1. In [Indic8](https://app.indic8.ing), go to **Settings > Integrations > Lemon Squeezy**.
2. Paste your API key into the **Lemon Squeezy API Key** field.
3. Click **Connect Lemon Squeezy**.

Indic8 will load your stores, products, historical sales, and recurring subscriptions.

***

## Part 3: Set up Real-Time Webhooks

<Steps>
  <Step title="Copy Indic8 Webhook URL">
    In Indic8 **Settings > Integrations > Lemon Squeezy**, copy:

    ```text theme={null}
    https://api.indic8.ing/v1/webhooks/lemonsqueezy/whk_live_xxxxxxxx
    ```
  </Step>

  <Step title="Create Webhook in Lemon Squeezy">
    1. In Lemon Squeezy, go to **Settings > Webhooks**.
    2. Click the **+** button.
    3. In **Callback URL**, paste your Indic8 Webhook URL.
    4. In **Secret**, enter a secure passphrase and copy it.
    5. Check the boxes for: `order_created`, `order_refunded`, `subscription_created`, `subscription_updated`, `subscription_cancelled`, and `license_key_created`.
    6. Click **Create Webhook**.
    7. Paste the secret passphrase into Indic8 under **Signing Secret** and click **Save**.
  </Step>
</Steps>