<!--
AppSprint docs markdown
Canonical HTML: https://appsprint.app/docs/superwall
Markdown URL: https://appsprint.app/docs/superwall.md
Docs index: https://appsprint.app/docs.md
Sitemap: https://appsprint.app/sitemap.xml
LLM guide: https://appsprint.app/llms.txt
-->

# Superwall

Forward Superwall webhook events to AppSprint so paywalls, trials, and subscription changes are attributed to the original install.

## Webhook endpoint

```
https://api.appsprint.app/v1/webhooks/superwall
```

Paste this URL into Superwall → Settings → Integrations → Webhooks.

## Authentication

Superwall signs webhooks using Svix. AppSprint verifies the signature using the webhook signing secret stored in your app's dashboard under Integrations → Superwall.

## Event mapping

| Superwall event | AppSprint event |
|----------------|-----------------|
| transaction_complete | purchase |
| subscription_start | subscribe |
| free_trial_start | start_trial |
| subscription_renew | renewal |
| subscription_cancel | cancellation |
| subscription_expire | expiration |

## Required: appsprintId user attribute

For webhooks to be matched to an attribution, you must set the `appsprintId` user attribute in Superwall from the SDK.

## SDK snippets

Set the user attribute after the AppSprint SDK is configured. In React Native and Flutter, `getAppSprintId()` is asynchronous, so await it before calling Superwall. See the Superwall docs page for platform-specific code snippets.

---

## Docs navigation

Use the Markdown URLs when reading the docs programmatically. Use the HTML URLs when you need the interactive docs UI.

- [Overview](https://appsprint.app/docs) ([Markdown](https://appsprint.app/docs.md)) — Introduction to AppSprint
- [Quickstart](https://appsprint.app/docs/quickstart) ([Markdown](https://appsprint.app/docs/quickstart.md)) — Get up and running in 5 minutes
- [React Native](https://appsprint.app/docs/react-native) ([Markdown](https://appsprint.app/docs/react-native.md)) — React Native / Expo SDK reference
- [iOS (Swift)](https://appsprint.app/docs/ios-swift) ([Markdown](https://appsprint.app/docs/ios-swift.md)) — Native Swift SDK reference
- [Android (Kotlin)](https://appsprint.app/docs/android) ([Markdown](https://appsprint.app/docs/android.md)) — Native Android SDK reference
- [Flutter](https://appsprint.app/docs/flutter) ([Markdown](https://appsprint.app/docs/flutter.md)) — Flutter plugin reference
- [RevenueCat](https://appsprint.app/docs/revenuecat) ([Markdown](https://appsprint.app/docs/revenuecat.md)) — Webhook integration for subscription attribution
- [Superwall](https://appsprint.app/docs/superwall) ([Markdown](https://appsprint.app/docs/superwall.md)) — Webhook integration for paywall attribution
- [Apple Search Ads](https://appsprint.app/docs/apple-search-ads) ([Markdown](https://appsprint.app/docs/apple-search-ads.md)) — Campaign and keyword attribution
- [Google Ads](https://appsprint.app/docs/google-ads) ([Markdown](https://appsprint.app/docs/google-ads.md)) — Offline click conversion upload
- [TikTok Ads](https://appsprint.app/docs/tiktok-ads) ([Markdown](https://appsprint.app/docs/tiktok-ads.md)) — Events API server-side event forwarding
