Amba
Integrations

Superwall

Integrate Superwall for paywall management and conversion tracking.

Connect Superwall to track paywall presentations, conversions, and dismissals within Amba.

Setup

1. Configure the integration

Via Admin API:

POST /admin/integrations
{
  "provider": "superwall",
  "config": {
    "api_key": "your_superwall_api_key",
    "shared_secret": "webhook_shared_secret"
  }
}

2. Set up the webhook

The API returns a webhook URL:

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

Add this in your Superwall dashboard under webhook settings.

3. Webhook events

EventAction
paywall_presentedLogs presentation event
paywall_dismissedLogs dismissal event
transaction_completeUpdates entitlements
subscription_startCreates entitlement
subscription_endDeactivates entitlement

Admin API reference

MethodPathDescription
POST/admin/integrationsConfigure integration
GET/admin/integrationsList active integrations
PATCH/admin/integrations/superwallUpdate config
POST/admin/integrations/superwall/testTest connection

Database tables

TablePurpose
project_integrationsIntegration config
user_entitlementsEntitlement records

Previous

RevenueCat

Next

Webhooks

On this page