> For the complete documentation index, see [llms.txt](https://connectyai.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://connectyai.gitbook.io/documentation/getting-started/data-connections-guide/stripe.md).

# Stripe

This guide shows how to give Connecty the **minimum access** needed to sync your **Stripe data** (payments, customers, subscriptions, invoices) into Connecty’s managed data warehouse.

### What you’ll do

You will create a **Stripe Restricted API key (read-only)** and provide it securely inside the Connecty app.

You’ll need:

* Your **Restricted API Key** (`rk_live_…`) ✅ **live mode only**
* (Optional) Your **Stripe Account ID** (`acct_…`)

✅ This does **not** require adding Connecty as a user to your Stripe account.

#### Step 1 — Create a Restricted (Read-only) API key in Stripe

1. Log in to your Stripe Dashboard
2. Make sure you are in **Live mode** (toggle in the top-right should NOT say “Viewing test data”)
3. Go to:\
   **Developers → API keys**
4. Click **“Create restricted key”**
5. Fill in:

* **Name:** `Connecty data sync`

6. Under **Permissions**, grant **Read** access to:

Recommended minimum:

* **Customers** → Read
* **Charges / Payment Intents** → Read
* **Invoices** → Read
* **Subscriptions** → Read
* **Products & Prices** → Read
* **Balance Transactions** → Read

(Leave everything else as **No access**)

7. Click **Create key**
8. Copy and save the key:

* **Restricted Key** (starts with `rk_live_…`)

> Important: This key provides access to your data. Store and share it securely.

#### Step 2 — Add your Stripe key in Connecty

1. Log in to your **Connecty app**
2. Go to: **Data Sources → Add Source → Stripe**
3. Paste:

* Your **Restricted API Key (`rk_live_…`)**
* (Optional) Your **Stripe Account ID (`acct_…`)**

4. Click **Connect**

#### **Notes**

* ❗ Only **live keys** are supported — test mode is not used in production
* Connecty uses **read-only access only** — no changes can be made to your Stripe account
* You can revoke or rotate the key anytime in Stripe
* If you have multiple Stripe accounts, connect each separately