RevenueCat

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

Setup

1. Configure the integration

Via MCP:

amba_configure_integration({
  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:

Event	Action
`INITIAL_PURCHASE`	Creates/updates user entitlement
`RENEWAL`	Extends entitlement expiry
`CANCELLATION`	Marks entitlement for expiry at period end
`EXPIRATION`	Deactivates entitlement
`BILLING_ISSUE`	Flags billing issue on entitlement

Webhook payloads are verified using HMAC with the shared secret.

Admin API reference

Method	Path	Description
`POST`	`/admin/integrations`	Configure integration
`GET`	`/admin/integrations`	List active integrations
`PATCH`	`/admin/integrations/revenuecat`	Update config
`POST`	`/admin/integrations/revenuecat/test`	Test connection

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

Database tables

Table	Purpose
`project_integrations`	Integration config (encrypted)
`user_entitlements`	Entitlement records with status and expiry