AppApex
Getting started·4 min read

Add Superwall + webhook

Superwall gives AppApex paywall funnel data - paywall views, trials, and conversions from its charts - plus real-time purchase events over webhooks. Together that is what lets the Conversion agent reason about how your paywalls are converting.

Why connect Superwall

RevenueCat tells you a purchase happened. Superwall adds the paywall funnel in front of it - how many people saw a paywall and how many converted. Connecting both gives the Conversion agent the full picture from impression to renewal.

Register the webhook

AppApex shows your unique endpoint URL on the Superwall integration card before you save anything. Add it in Superwall first - Superwall reveals the signing secret when the endpoint is created.

  1. 1
    Open Superwall webhooks

    In Superwall go to Settings, then Webhooks, and add a new endpoint with the AppApex URL.

  2. 2
    Copy the signing secret

    Superwall shows a whsec_ signing secret when the endpoint is created. Copy it - AppApex uses it to verify every delivery.

Example endpoint URL (yours is unique to your account)text
https://app.appapex.io/api/webhooks/superwall/u/8f21c0a4-...

Connect it in AppApex

  1. 1
    Create an API key

    In Superwall go to Settings, then API Keys, and create an organization key with read access to projects and charts. The token is shown once - copy it. The pk_ SDK key will not work.

  2. 2
    Paste your credentials

    In AppApex, paste your numeric application ID, the API key, and the whsec_ signing secret from the webhook step, then save. AppApex validates the key and backfills your paywall funnel history.

Superwall and RevenueCat events are reconciled by transaction ID, so running both never double-counts a conversion.