Skip to main content
Adapty is a comprehensive mobile subscription management platform that simplifies in-app purchase infrastructure, A/B testing, and analytics. This centralized hub enables businesses to manage subscription lifecycles by providing the necessary tools to attract, engage, and retain subscribers through data-driven insights.

​
Key Features

The MoEngage and Adapty integration provides the following capabilities to help you manage and track your mobile subscription data:
  • Comprehensive subscription lifecycle tracking : Synchronize more than 15 real-time events, including subscription_started, renewal_cancelled, billing_issue_detected, and grace_period.
  • Revenue and tax validation : Access a detailed breakdown of net_revenue, tax_amount, and proceeds in both USD and local currencies.
  • User and attribution synchronization : Automatically forward custom user attributes, attribution data (such as AppsFlyer), and third-party integration IDs.
  • Access level management : Perform granular tracking of trial conversions, subscription pauses (for Android), and updates to lifetime access.

​
Use cases

Integrating Adapty with MoEngage helps you with the following use cases:
  • Churn prevention and win-back : Trigger automated email or push sequences in MoEngage when a Subscription Canceled event is detected to recover users before their access expires.
  • Payment recovery : Automatically prompt users to update their payment methods via SMS or push notifications in MoEngage when a Billing Issue event is received.
  • Trial conversion optimization : Initiate onboarding journeys in MoEngage for users who trigger a Trial Started event to highlight premium value before the trial ends.
  • Upsell to premium : Identify loyal subscribers through Subscription Renewed events and trigger exclusive offers for higher-tier annual plans.

​
Integration

Before you begin, ensure you have the following:
  • Admin permissions in Adapty to configure webhooks.
  • Admin access in MoEngage to retrieve API credentials.
  • A dedicated MoEngage ingestion endpoint obtained from MoEngage Support.
    Note : When requesting the endpoint, specify the Customer Identifier (for example, profile_id or UUID) used to link user profiles between Adapty and MoEngage.

​
Step 1: Generate Authentication Credentials

Adapty requires a Basic Authentication token to securely send data to MoEngage. To generate authentication credentials, perform the following steps:
  1. On the MoEngage UI, navigate to Settings > Account > APIs.
  2. Copy the following credentials to be used for your token:
    1. Username : Copy the ID under Workspace ID (earlier app id).
    2. Password : In the API keys section, copy the API key from the Data tile.
  3. Use an online Basic Auth Header Generator (or a tool like Postman) to generate your token:
    • Username : {Your_Workspace_ID}
    • Password : {Your_Data_API_Key}
Note : Your Basic Authentication token is a combination of your Workspace ID and Data API Key.

​
Step 2: Configure the Webhook in Adapty

To configure the Webhook in Adapty, perform the following steps:
  1. Log in to the Adapty UI.
  2. On the left navigation menu, click Integrations.
  3. Scroll to the Server section and click webhooks.
  4. Turn the Webhook toggle on.
  5. Configure the following settings:
FieldValue / Action
Production Endpoint URLEnter the URL provided by MoEngage Support. Format: https://api-0X.moengage.com/v1/partner/adapty/{events}/?configName={config_name}.
Authorization ValuePaste the Basic Auth token generated in step 1 (for example: Basic Qk5CR1NNNUR4eHh4…).

​
Step 3: Select Data and Events

After entering the connection details, to configure the data payload, perform the following steps:
  1. In the Data Options section, select the following check boxes:
    • Send attribution: Forwards ad network data (for example, AppsFlyer or Adjust).
    • Send user attributes : Forwards custom user profile data.
    • Send Play Store purchase token: Required for validation on Android devices.
  2. In the Event Names section, select the specific events you want to track in MoEngage (such as subscription_started or trial_converted).
  3. Click Save at the top of the pane to activate the integration.

​
Step 4: Verify Data in MoEngage

After you configure the webhooks, generate a test event in your Adapty application and validate the data within the MoEngage UI. To verify data in MoEngage, perform the following steps:
  1. Log in to the MoEngage UI.
  2. On the left navigation menu, navigate to Segments > Search Users.
  3. In the Search Users search box, locate a test user by using one of the following identifiers:
    • Customer ID
    • Email address
    • Phone number
  4. Verify that the profile contains the following information:
    • Event attributes : Confirm that the subscription event details (for example, subscription_started) are listed under the events section.
    • User attributes : If you selected user attribute synchronization in Step 3 ,ensure these are reflected under the attributes section.
    • Latest interaction timestamp : Check the latest interaction timestamp to ensure it matches the time of your test event.