RevenueCat

Connect a project

1. As a workspace owner or admin, select Connect in the RevenueCat panel.

2. Supply a RevenueCat secret v2 API key (sk_…) with access to the project and charts_metrics:overview:read permission.

3. If the key can see multiple projects, choose the intended project and submit again.

4. AppNorth checks project access and the overview metrics request before saving the connection and its first snapshot.

The public SDK key used in an iOS app is not the secret key this integration expects. AppNorth seals the secret on the server and does not return it in connection responses.

Understand the metrics

The overview maps RevenueCat metrics to MRR, revenue over 28 days, active subscriptions, active trials, new customers over 28 days and active users over 28 days. Currency comes from the provider response.

These are project-level metrics. If one RevenueCat project contains several apps, its overview is not filtered down to the individual AppNorth app. Choose the project accordingly and avoid adding the same project's figures together as if they were independent app revenue.

Unavailable metrics remain unknown. A missing snapshot is not zero revenue. Check the last synchronization time before using the figures.

AppNorth stores one snapshot per app per UTC day and updates that day's row when the revenue job runs. The overview reads up to 90 days of stored history. Connecting starts collection; it does not backfill 90 days of history. Background refresh depends on the deployment's revenue job.

Change or remove the connection

Use Change key to verify and replace credentials, or Disconnect to stop using the connection. Previously collected snapshots remain as history. If you switch RevenueCat projects, remember that retained history may describe the former project.

PROJECT_REQUIRED asks you to select a project. MISSING_PERMISSION means the overview permission is missing; CREDENTIALS_REJECTED means the provider rejected the key. See Errors for encryption and service failures.

This integration reads metrics. Paywall cards separately configure how your iOS app handles offers in support chat.