Documentation Index
Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Use RevenueCat as a data source for Chartcastr. Connect your project with a V2 Secret API Key and Chartcastr will pull subscription metrics like MRR, active subscribers, new subscribers, churn rate, and trial counts to generate charts delivered automatically to Slack or email. RevenueCat is the leading subscription management platform for mobile and web apps. Chartcastr connects with read-only access via RevenueCat’s V2 REST API — no SDK changes required.Setup
Create a V2 Secret API Key in RevenueCat
In the RevenueCat dashboard, open Project Settings → API Keys and create a new key (or edit an existing one). Set API version to V2 and grant the read-only permissions listed below — Chartcastr never writes to your RevenueCat project.
The fastest setup is to set the Charts metrics permissions section header to Read only (which applies it to all four rows at once), then expand Project configuration permissions and switch Projects Configuration to Read only. Leave every other section on No access.
| Section | Permission | Access Level |
|---|---|---|
| Charts metrics permissions | Overview Configuration | Read only |
| Charts metrics permissions | Charts Configuration | Read only |
| Charts metrics permissions | Benchmarks Configuration | Read only |
| Charts metrics permissions | Experiment results Configuration | Read only |
| Project configuration permissions | Projects Configuration | Read only |
| Customer information permissions | (all) | No access |
| Project configuration permissions | Collaborators / Apps / Audit logs | No access |
Projects Configuration → Read only is required so Chartcastr can list the project the key belongs to and bind the integration automatically. Without it the connect step fails with
The API key needs at least the project_configuration:projects:read permission defined.Connect in Chartcastr
In Chartcastr, go to Admin → Settings → Source Integrations, find RevenueCat, click Connect, and paste your V2 Secret API Key. Chartcastr will detect the project the key is scoped to and confirm the connection — you do not need to paste a Project ID.
Select a metric
Choose which subscription metric to track. Each metric becomes its own source. You can add multiple sources to send different charts on different schedules.
Troubleshooting
“RevenueCat connection failed: The API key needs at least the project_configuration:projects:read permission defined”
“RevenueCat connection failed: The API key needs at least the project_configuration:projects:read permission defined”
The API key is valid but does not have permission to list projects, so Chartcastr cannot bind it to a project. In RevenueCat, edit the key and set Project configuration permissions → Projects Configuration to Read only, then retry the connect.
“API key was rejected” / 401 errors
“API key was rejected” / 401 errors
Confirm the key starts with
sk_ (a V2 Secret key, not a publishable or v1 key), that API version is set to V2, and that the key has not been revoked in Project Settings → API Keys.Charts load empty after connecting
Charts load empty after connecting
Chartcastr reads from the Overview and Charts endpoints. If those rows are set to No access, the connect succeeds but every metric returns no data. Grant Read only on Overview Configuration and Charts Configuration under Charts metrics permissions.
Available Metrics
Chartcastr supports 6 pre-built RevenueCat metrics across three categories.Revenue
Monthly Recurring Revenue (MRR) and Revenue Per Day.
Subscribers
Active subscribers, new subscribers per day, and active trial counts.
Churn
Monthly churn rate trend to monitor subscriber retention.
View all available charts
See the full list of RevenueCat metrics with chart types and descriptions.
Next Steps
Slack destination
Deliver RevenueCat charts to your Slack channels with AI summaries in the thread.
Email destination
Schedule RevenueCat subscription reports to any inbox or distribution list.