RevenueCat

Connect RevenueCat to sync subscription status and entitlements with Amba. When a user subscribes via RevenueCat, their entitlements are automatically updated in Amba.

RevenueCat handles App Store and Play Store subscriptions. For non-mobile flows — Stripe / Paddle web checkout, manual support grants, gift codes, ToS-violation revokes, migrations from legacy systems — use POST /admin/projects/:projectId/users/:userId/entitlements to grant the same entitlement directly. Both paths produce the same entitlement and are read through the same client API.

Setup

1. Configure the integration

Via MCP:

amba_integrations_configure({
  project_id: "proj_xxx",
  provider: "revenuecat",
  config: {
    api_key: "your_revenuecat_api_key",
    shared_secret: "webhook_shared_secret"
  }
})

Via Admin API:

POST /admin/integrations
{
  "provider": "revenuecat",
  "config": {
    "api_key": "your_revenuecat_api_key",
    "shared_secret": "webhook_shared_secret"
  }
}

2. Set up the webhook

The API returns a webhook URL when you configure the integration:

https://api.amba.dev/webhooks/revenuecat?project_id=proj_xxx

Add this URL in your RevenueCat dashboard under Project Settings > Integrations > Webhooks.

3. Webhook events

Amba processes these RevenueCat webhook events:

Webhook payloads are verified using HMAC with the shared secret.

Admin API reference

Checking entitlements in the SDK

const entitlements = await client.entitlements.getAll();
// Returns: [{ id: "premium", is_active: true, expires_at: "2025-02-14T..." }]
 
const isPremium = await client.entitlements.isActive('premium');
// Returns: true