Instally Docs

Webhook Integrations

Connect your subscription platform to automatically track purchases, renewals, and cancellations — attributed to the source that drove the install.


How it works

1

Add one line of code after trackInstall() to link the subscription platform's user ID to the attributed install.

2

Paste the webhook URL in your subscription platform's dashboard. Replace YOUR_WEBHOOK_SECRET with your webhook secret from your Instally dashboard (Settings → Webhook Secret).

3

Done. Every purchase, renewal, and cancellation is now attributed automatically.


RevenueCat

Step 1: Link the user ID

Add this after Instally.trackInstall():

iOS
Instally.setUserId(Purchases.shared.appUserID)

Step 2: Add the webhook

In RevenueCat: Dashboard → Integrations → Webhooks → paste URL

https://us-central1-instally-5f6fd.cloudfunctions.net/api/v1/webhooks/revenuecat?secret=YOUR_WEBHOOK_SECRET

Superwall

Step 1: Link the user ID

Add this after Instally.trackInstall():

iOS
Instally.setUserId(Superwall.shared.userId)

Step 2: Add the webhook

In Superwall: Dashboard → Integrations → Webhooks → paste URL

https://us-central1-instally-5f6fd.cloudfunctions.net/api/v1/webhooks/superwall?secret=YOUR_WEBHOOK_SECRET

Adapty

Step 1: Link the user ID

Add this after Instally.trackInstall():

iOS
Instally.setUserId(Adapty.getProfile().profileId)

Step 2: Add the webhook

In Adapty: Dashboard → Integrations → Webhooks → paste URL

https://us-central1-instally-5f6fd.cloudfunctions.net/api/v1/webhooks/adapty?secret=YOUR_WEBHOOK_SECRET

Qonversion

Step 1: Link the user ID

Add this after Instally.trackInstall():

iOS
Instally.setUserId { try await Qonversion.shared().userInfo().qonversionId }

Step 2: Add the webhook

In Qonversion: Dashboard → Settings → Webhooks → paste URL

https://us-central1-instally-5f6fd.cloudfunctions.net/api/v1/webhooks/qonversion?secret=YOUR_WEBHOOK_SECRET

Stripe

Step 1: Link the user ID

Add this after Instally.trackInstall():

iOS
Instally.setUserId(stripeCustomerId)

Step 2: Add the webhook

In Stripe: Dashboard → Developers → Webhooks → Add endpoint

https://us-central1-instally-5f6fd.cloudfunctions.net/api/v1/webhooks/stripe?secret=YOUR_WEBHOOK_SECRET

Select the invoice.paid and customer.subscription.deleted events.


That's it

Once the webhook is configured, all purchases, renewals, and cancellations are automatically recorded and attributed to the source that drove the install. View revenue per link, source, and campaign in your dashboard.