Before you start
Admin access to the RevenueCat project, to create a dedicated V2 secret API key. The app’s public key and V1 keys do not work.
Set it up
- Select your project → API keys → Secret API keys → New secret API key.
- Name it
Sprid analyticsand select V2. - Charts metrics permissions: set Overview Configuration Access Level and Charts Configuration Access Level to Read only.
- Project configuration permissions: set Apps Configuration Access Level to Read only. Leave everything else at No access.
- Click Generate and save the key to a private file such as
~/keys/revenuecat-myapp.txt. Use a separate key per app.
Project id
Project settings → General → Project ID, such as proj1ab2c3d4. Not the shorter id in the dashboard address.
Connect to Sprid
sprid connect revenuecat --app myapp --key ~/keys/revenuecat-myapp.txt --project proj1ab2c3d4Use your own app slug, file path and project id. Add --workspace <slug> if needed. Keep the key out of chat.
Check the connection
Ask your agent: “Check that Sprid can read this app’s RevenueCat overview and daily revenue history. Report any missing dates.” A saved key alone does not confirm access. The overview can work while history does not; missing dates are not zero sales.
If you also sell on the web
Connect the services that record the other sales. Sprid withholds a combined total when RevenueCat may already include the same Stripe or Paddle sales, or when currencies or definitions differ. RevenueCat Web Billing and your own Stripe are separate merchant accounts, so they never overlap.
If something goes wrong
- Key rejected: check it is an active V2 secret key for this project.
- Access denied or history missing: open the key’s More → Edit, check all three Read only settings, then Submit. No new key needed.
- Project not found: copy the full Project ID from Project settings → General. Key and id must belong to the same project.
- Too many requests: retry later. Another key will not help.
Investigate with this connection
Reads chart_options, chart and subscriptions for the pinned project. Read chart_options before picking dimensions, filters or resolution, and keep the returned units. subscriptions also needs customer_information:subscriptions:read and defaults to production; ask for sandbox to see test purchases.
sprid marketing-review capabilities --app <slug> --source revenuecat --jsonSee connected queries.
Sources and verification
Setup and live reads checked 2026-09-09.
Prefer your terminal? sprid docs revenuecat reads this same guide.