RevenueCat

Stream subscription events from RevenueCat into the Capreolus revenue dashboard.

Capreolus consumes both the RevenueCat REST API (for backfills) and the RevenueCat webhook (for real-time events). The webhook is what keeps MRR and churn numbers in sync within seconds of a subscription event.

1. Get a Secret API Key

Open the RevenueCat dashboard and go to Project Settings → API Keys.
Copy the Secret API Key (not the public SDK key). It begins with sk_.
Paste it into Capreolus under Settings → Integrations → RevenueCat.

2. Configure the webhook

In RevenueCat under Project Settings → Integrations → Webhooks, add a new webhook with this URL template:

text

https://api.capreolus.app/api/saas/iap/revenuecat/webhook?app={slug}

Replace {slug} with the slug of the Capreolus app this RevenueCat project maps to. You can find the slug on the app card in your dashboard.

3. Authorization header

RevenueCat lets you set a custom Authorizationheader on each webhook. Generate a long random string in the Capreolus integration settings page — this is the value RevenueCat will send, and Capreolus will refuse any webhook that doesn't match it.

http

Authorization: Bearer <random-string-from-capreolus>

What we listen for

INITIAL_PURCHASE, RENEWAL, CANCELLATION, EXPIRATION
BILLING_ISSUE, NON_RENEWING_PURCHASE
SUBSCRIBER_ALIAS, TRANSFER (for shared subscriptions)

The RevenueCat integration powers two things at once: revenue metrics for the apps you track, and Capreolus's own subscription billing if you upgrade through Apple Pay or Google Pay. They use different webhook URLs — the dashboard shows you which.