Skip to content

All integrations

Connect RevenueCat to ShipVitals

In-app revenue, store commission, tax, MRR and active subscriptions

BetaRead-only key · about 3 minutes

Beta: this connector is new in the beta, and we're still checking it against more accounts.

Connect RevenueCat

What it reads

project_configuration:projects:read
Names the project the key belongs to
project_configuration:apps:read
Lists the store apps to match to projects
project_configuration:products:read
Tells which app a product belongs to
customer_information:customers:read
Lists customers, as one-way hashes
customer_information:subscriptions:read
Reads subscriptions and their transactions for revenue and MRR
customer_information:purchases:read
Reads one-time purchases
charts_metrics:overview:read
Reads active subscriptions and trials

Read-only: ShipVitals can't change anything at RevenueCat.

What ShipVitals keeps: A read-only v2 secret key, encrypted; customer ids only as a one-way hash. Purchases through Stripe or Paddle are left to those connectors.

Every connector's scopes, on one page

How to connect

  1. In RevenueCat, open your project's Project settings → API keys.
  2. Choose + New secret API key, name it ShipVitals and pick version V2.
  3. Give it read-only access to the permissions listed below, nothing else.
  4. Generate it and copy the key. It starts with sk_.

About 3 minutes.

Open RevenueCat

How to revoke

Revoke it at RevenueCat

Removing the connection in ShipVitals deletes the stored key at once.

What it powers

Dashboard tabs: Revenue.

Figures it fills

  • Active subscriptions
  • Active trials

Sync

  • Free: Daily
  • Indie: Hourly
  • Studio: Every 15 minutes
  • Agency: Every 15 minutes

Troubleshooting

Each error a connection can hit, and its fix. The connection's health page names the one it hit.

Access refused
RevenueCat didn't accept the key. Use a v2 secret key (v1 keys don't work with API v2), or make a new one and paste it.
A permission is missing
This key can't read everything ShipVitals needs. Make a v2 secret key with the read permissions listed below.
Access removed
ShipVitals' access was removed in RevenueCat. Connect it again; the history it brought in is kept.
Rate-limited
RevenueCat asked ShipVitals to slow down. Nothing to do: the sync carries on by itself and catches up.
Quota reached
The account used up a RevenueCat quota. The sync resumes when the quota resets.
Not found
Something the connection reads is gone from RevenueCat: renamed, moved or removed. Review the connection's resources, or connect again.
RevenueCat is unavailable
RevenueCat is having trouble on its side. Check its status page; ShipVitals retries by itself.
Couldn't reach RevenueCat
The request didn't get through. ShipVitals retries by itself; if it keeps failing, check that RevenueCat is reachable.
An answer ShipVitals didn't expect
RevenueCat answered in a shape ShipVitals didn't expect, usually after a change on its side. We're told, and the data you have is kept.
A setting doesn't work
A field in the connection doesn't work with RevenueCat. Check it against How to connect, and test again.

Docs