> ## 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.

# RevenueCat source

> Connect RevenueCat to Chartcastr for automated subscription metrics charts. Track MRR, subscriber counts, churn rate, and trials delivered to Slack or email.

## 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

<Steps>
  <Step title="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.

    | 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     |

    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**.

    <Note>
      **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`.
    </Note>

    <Warning>
      Anyone with the Secret API Key can query your project's chart data. Chartcastr stores it encrypted at rest with AES-256-GCM, but treat the key as a credential and rotate it through RevenueCat if it ever leaks.
    </Warning>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Create a connection">
    Pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="“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.
  </Accordion>

  <Accordion title="“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**.
  </Accordion>

  <Accordion title="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**.
  </Accordion>
</AccordionGroup>

## Available Metrics

Chartcastr supports **6 pre-built RevenueCat metrics** across three categories.

<CardGroup cols={2}>
  <Card title="Revenue" icon="dollar-sign">
    Monthly Recurring Revenue (MRR) and Revenue Per Day.
  </Card>

  <Card title="Subscribers" icon="users">
    Active subscribers, new subscribers per day, and active trial counts.
  </Card>

  <Card title="Churn" icon="arrow-trend-down">
    Monthly churn rate trend to monitor subscriber retention.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/revenuecat/available-charts">
  See the full list of RevenueCat metrics with chart types and descriptions.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver RevenueCat charts to your Slack channels with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule RevenueCat subscription reports to any inbox or distribution list.
  </Card>
</CardGroup>