# 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


---

# 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://connectyai.gitbook.io/documentation/getting-started/data-connections-guide/stripe.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.