Skip to main content
Linkrunner integrates with RevenueCat to automatically track revenue and subscription data. Once configured, RevenueCat will send webhook events whenever subscription or revenue events occur. Linkrunner will automatically match these events with attributed users to provide you with revenue analytics per campaign.

​
How it works

Unlike other analytics integrations that push data from Linkrunner, RevenueCat uses a webhook-based approach:
  1. RevenueCat sends webhook events to Linkrunner whenever a subscription or revenue event occurs
  2. Linkrunner automatically matches these events with attributed users
  3. RevenueCat events are automatically mapped to Linkrunner revenue types
  4. Events are categorized into three status types based on payment outcome

​
Prerequisites

RequirementDescription
Linkrunner accountA Linkrunner account is required to take advantage of this integration.
RevenueCat accountA RevenueCat account with webhook access.
iOS or Android appThis integration supports iOS and Android apps.
Linkrunner SDKYou must have the Linkrunner SDK installed in your app.

​
Steps to setup

1

Navigate to Integrations

In your Linkrunner dashboard, click on Integrations from the left-hand panel. Under the Analytics section, find RevenueCat and click Configure.
Navigate to RevenueCat integration
2

Copy the Webhook URL

In the RevenueCat configuration panel, you’ll see the Webhook URL. Copy this URL — you’ll need to add it to your RevenueCat dashboard.The webhook URL is: https://api.linkrunner.io/webhook/revenuecat
Copy the webhook URL
3

Generate an Authorization Token

Click Generate Authorization Token in the Linkrunner configuration panel. Copy the generated token — you’ll need this for the authorization field in RevenueCat.
Generate authorization token
4

Configure Webhook in RevenueCat

Now head to your RevenueCat dashboard to set up the webhook:
  1. In your RevenueCat dashboard, navigate to the Integrations page from the left sidebar
  2. Under RevenueCat core tools, click on Webhooks to configure the integration
RevenueCat Integrations page - click on Webhooks
  1. Click Add Webhook and fill in the following details:
    • Webhook name: Linkrunner
    • Webhook URL: Paste the webhook URL copied from the Linkrunner dashboard
    • Authorization header value: Paste the authorization token generated in the Linkrunner dashboard
    • Environment to send events for: Select Both Production and Sandbox (recommended)
    • Events filter: Select All apps and All events (recommended)
  2. Click Add webhook to save
RevenueCat New Webhook configuration

​
Event Type Mapping

RevenueCat events are automatically mapped to Linkrunner revenue types:
RevenueCat EventLinkrunner Revenue TypeDescription
INITIAL_PURCHASEFIRST_PAYMENTFirst subscription purchase
RENEWALSUBSCRIPTION_RENEWEDSubscription renewal payment
NON_RENEWING_PURCHASEONE_TIMEOne-time purchase
CANCELLATIONSUBSCRIPTION_CANCELLEDUser cancelled subscription
UNCANCELLATIONSUBSCRIPTION_RENEWEDUser reactivated subscription
REFUNDSUBSCRIPTION_REFUNDEDPayment refunded to user
BILLING_ISSUESUBSCRIPTION_BILLING_ISSUEPayment failed or billing problem
PRODUCT_CHANGESUBSCRIPTION_RENEWEDUser changed subscription tier
EXPIRATIONDEFAULTSubscription expired naturally

​
Event Status Mapping

Events are categorized into three statuses based on the payment outcome:
StatusEvents
Payment CompletedINITIAL_PURCHASE, RENEWAL, NON_RENEWING_PURCHASE, UNCANCELLATION, PRODUCT_CHANGE
Payment FailedBILLING_ISSUE
Payment CancelledCANCELLATION, REFUND

​
Viewing Revenue Data

After the integration is complete, Linkrunner will automatically:
  • Match incoming RevenueCat events with attributed users
  • Map events to the corresponding Linkrunner revenue types
  • Provide revenue analytics per campaign in your Linkrunner dashboard
This data helps you understand which campaigns are driving the most valuable users in terms of subscription revenue and lifetime value.