> ## 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.

# RevenueCat Setup Guide

> Step-by-step guide to connect RevenueCat REST API v2 Keys and Webhooks to Indic8.

Connect RevenueCat to consolidate mobile in-app purchases, iOS subscriptions, Android sales, and Stripe web payments in one place.

## What You Need to Connect

| Credential                       | Where to find it in RevenueCat | Description                                                                  |
| :------------------------------- | :----------------------------- | :--------------------------------------------------------------------------- |
| **RevenueCat Secret API Key**    | Project Settings > API Keys    | Used by Indic8 to query customer subscriber records and product entitlements |
| **Webhook Authorization Header** | Generated in Indic8 settings   | Verifies real-time push events from RevenueCat                               |

***

## Part 1: Generate a RevenueCat Secret API Key

<Steps>
  <Step title="Open RevenueCat Project Settings">
    1. Log in to the [RevenueCat Dashboard](https://app.revenuecat.com).
    2. Select your Project from the top navigation dropdown.
    3. In the left sidebar, click the **Project Settings** (gear icon).
  </Step>

  <Step title="Navigate to API Keys">
    1. Click **API Keys** in the settings submenu.
    2. Look for the section titled **REST API v2 Keys** (or **v1 API Keys**).
  </Step>

  <Step title="Create New Secret Key">
    1. Click **+ Generate Key** (or **Create Key**).
    2. Set **Key Name** to: `Indic8 Analytics Sync`.
    3. Grant read permissions for project subscriber data.
    4. Click **Generate Key**.
    5. Copy the secret key (starts with `sk_...` or `rc_...`).
  </Step>
</Steps>

***

## Part 2: Connect Key in Indic8

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

***

## Part 3: Set up Real-Time Webhooks

<Steps>
  <Step title="Copy Indic8 Webhook URL & Token">
    In Indic8 **Settings > Integrations > RevenueCat**, copy:

    * **Webhook URL**: `https://api.indic8.ing/v1/webhooks/revenuecat/whk_live_xxxxxxxx`
    * **Authorization Token**: A generated authorization secret string.
  </Step>

  <Step title="Add Webhook in RevenueCat">
    1. In RevenueCat, go to **Project Settings > Integrations > Webhooks**.
    2. Click **+ Add Webhook**.
    3. Paste your Indic8 Webhook URL.
    4. In **Authorization Header Value**, paste your Authorization Token.
    5. Check **Production** (and optionally **Sandbox** for Xcode Simulator test builds).
    6. Click **Save**.
  </Step>
</Steps>