Adapty

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

library_add_check

Prerequisites

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:

On the MoEngage UI, navigate to Settings > Account > APIs.
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.
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:

Log in to the Adapty UI.
On the left navigation menu, click Integrations.
Scroll to the Server section and click webhooks.
Turn the Webhook toggle on.
Configure the following settings:

Field	Value / Action
Production Endpoint URL	Enter the URL provided by MoEngage Support. Format: https://api-0X.moengage.com/v1/partner/adapty/{events}/?configName={config_name}.
Authorization Value	Paste 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:

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.
In the Event Names section, select the specific events you want to track in MoEngage (such as subscription_started or trial_converted).
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:

Log in to the MoEngage UI.
On the left navigation menu, navigate to Segments > Search Users.
In the Search Users search box, locate a test user by using one of the following identifiers:
- Customer ID
- Email address
- Phone number
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.