Before you start
- You need a RevenueCat account with at least one project (your app). If your app isn’t in RevenueCat yet, add it there first — Stratos reads numbers, it can’t create them.
- You need to be the project’s owner or admin to create API keys.
Step 1 — Open your project’s API keys
- Sign in at app.revenuecat.com.
- Pick the project for your app (top-left project switcher).
- Go to Project settings → API keys.
Step 2 — Create a secret key just for Stratos
- Click + New secret API key.
- Name it
Stratosso you can recognise (and revoke) it later. - Under permissions, give it Read on Charts & metrics — nothing else. Stratos never needs to write to RevenueCat or see customer data.
- Click Generate. The key starts with
sk_. Copy it now — RevenueCat shows it only once.
Use a secret key (
sk_…), not a public SDK key. Public keys can’t read metrics, and Stratos will tell you so if you paste one.Step 3 — Paste it into Stratos
- In Stratos, open Dashboard and find the Business card.
- Paste the key and click Connect.
- Stratos calls RevenueCat once to verify the key and find your project, then stores the key encrypted. You’ll see “Connected — pulling numbers for Your app”.
What you’ll see
Disconnecting
Dashboard → Business → Disconnect. The key is deleted from Stratos immediately. You can also revoke it on RevenueCat’s side at any time (Project settings → API keys → revoke) — Stratos will show the panel as disconnected on its next refresh.Troubleshooting
- “RevenueCat didn’t accept that key” — you pasted a public key, or the secret key lacks Charts & metrics read permission. Create a new secret key with that permission.
- “That key works, but its RevenueCat account has no projects yet” — add your app as a project in RevenueCat first.
- Numbers look a day behind — that’s RevenueCat’s store sync cadence, not Stratos.