RevenueCat API

Integrate with RevenueCat to manage cross-platform subscriptions. Sync your App Store products to RevenueCat and manage offerings.

Setup Required: Before using these endpoints, configure your RevenueCat credentials in Project Settings. You'll need your RevenueCat Secret API Key and Project ID.

Check if RevenueCat is configured and connected for a project. Returns apps and products.

GET /revenuecat/status

Authentication

Requires API key with Authorization: Bearer <api_key> header

URL Parameters

Name	Type	Required	Description
`projectId`	`string`	Yes	The project ID

Response Example

{
  "configured": true,
  "connected": true,
  "apps": [
    {
      "id": "app_abc123",
      "name": "My App (iOS)",
      "type": "app_store",
      "bundle_id": "com.example.myapp"
    }
  ],
  "products": [
    {
      "id": "prod_xyz",
      "store_identifier": "com.app.premium_monthly",
      "type": "subscription",
      "display_name": "Premium Monthly"
    }
  ]
}

Code Examples

curl "https://api.appstorecopilot.com/v1/revenuecat/status?projectId=proj_123" \
  -H "Authorization: Bearer $ASC_API_KEY"

Create a new app in RevenueCat. Automatically uses your App Store Connect credentials.

POST /revenuecat/apps

Authentication

Requires API key with Authorization: Bearer <api_key> header

Request Body

Name	Type	Required	Description
`projectId`	`string`	Yes	The project ID
`name`	`string`	Yes	App name (e.g., "My App (iOS)")
`type`	`string`	Yes	app_store for iOS, play_store for Android
`bundleId`	`string`	No	iOS bundle identifier (required for app_store type)
`packageName`	`string`	No	Android package name (required for play_store type)

Response Example

{
  "success": true,
  "app": {
    "id": "app_abc123",
    "name": "My App (iOS)",
    "type": "app_store",
    "bundle_id": "com.example.myapp",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Code Examples

curl -X POST "https://api.appstorecopilot.com/v1/revenuecat/apps" \
  -H "Authorization: Bearer $ASC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "proj_123",
    "name": "My App (iOS)",
    "type": "app_store",
    "bundleId": "com.example.myapp"
  }'

When creating an iOS app, your App Store Connect credentials (private key, key ID, issuer ID) are automatically passed to RevenueCat for receipt validation and product import.

Sync your in-app purchases and subscriptions from App Store Copilot to RevenueCat.

POST /revenuecat/sync

Authentication

Requires API key with Authorization: Bearer <api_key> header

Request Body

Name	Type	Required	Description
`projectId`	`string`	Yes	The project ID
`appId`	`string`	Yes	RevenueCat app ID to sync products to
`productIds`	`string[]`	No	Specific product IDs to sync (all if not specified)

Response Example

{
  "success": true,
  "created": ["com.app.premium_monthly", "com.app.premium_annual"],
  "skipped": ["com.app.coins_100"],
  "errors": [],
  "summary": {
    "total": 3,
    "created": 2,
    "skipped": 1,
    "errors": 0
  }
}

Code Examples

curl -X POST "https://api.appstorecopilot.com/v1/revenuecat/sync" \
  -H "Authorization: Bearer $ASC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "proj_123",
    "appId": "app_abc123"
  }'

Test the RevenueCat API connection with provided credentials.

POST /revenuecat/test

Authentication

Requires API key with Authorization: Bearer <api_key> header

Request Body

Name	Type	Required	Description
`secretKey`	`string`	Yes	RevenueCat Secret API Key
`projectId`	`string`	Yes	RevenueCat Project ID

Response Example

{
  "success": true,
  "message": "Connection successful",
  "appsCount": 2,
  "productsCount": 5
}

Configuration

To use RevenueCat integration, add your credentials in Project Settings:

Go to your project's Settings page
Scroll to the "RevenueCat" section
Enter your RevenueCat Secret API Key (starts with sk_)
Enter your RevenueCat Project ID (starts with proj)
Click "Test Connection" to verify
Save your settings

Find your RevenueCat credentials in the RevenueCat dashboard under Project Settings → API Keys.