Step 1: Understand the MoEngage Ecosystem
Before you start building, take a few minutes to understand how the MoEngage partner ecosystem works and what tools are available to you.Essential Reading
App Marketplace
Where your integration will be listed and discovered by customers.
Guidelines
Best practices and requirements for building a robust integration.
Key Concepts
Glossary of terms and concepts you’ll encounter throughout.
Explore What’s Possible
MoEngage supports a wide range of integration patterns. Understanding the use cases below will help you choose the right approach for your platform.Send Data to MoEngage — Sync user profiles, events, and segments into MoEngage
Send Data to MoEngage — Sync user profiles, events, and segments into MoEngage
- Send User Data: Sync user profiles and attributes from your platform to MoEngage.
Receive Data from MoEngage — Stream data from MoEngage to your platform
Receive Data from MoEngage — Stream data from MoEngage to your platform
- Receive Data: Stream user and event data from MoEngage to your platform in real-time.
Trigger & Run Campaigns — Initiate campaigns from your app or use external content
Trigger & Run Campaigns — Initiate campaigns from your app or use external content
- Trigger Campaigns: Initiate marketing campaigns in MoEngage based on actions in your application.
- Use External Creatives: Allow marketers to use images, GIFs, and other creatives from your platform within MoEngage campaigns.
Enrich & Personalize — Fetch real-time data or create dynamic content
Enrich & Personalize — Fetch real-time data or create dynamic content
- Dynamically Fetch Data: Enrich MoEngage campaigns with real-time data from your application.
- Create Content Creatives: Enable the creation of dynamic, personalized content for use in campaigns.
Step 2: Get Your Sandbox
To start building, you’ll need a MoEngage Sandbox Workspace. This is a dedicated environment where you can explore the platform, build your integration, and test it thoroughly before going live.Request Your SandboxFollow the Account Setup guide to request access. You’ll receive sandbox credentials within 1–2 business days.
Step 3: Choose Your Integration Path
MoEngage offers two primary pathways for building your integration. The right choice depends on your use case, technical requirements, and how much control you need.Connected Apps — Low-Code Framework (Recommended)
Define your integration logic in a simple config file. No heavy engineering required.Two sub-types:
- Connected Sources: send data into MoEngage via webhooks.
- Connected Channels: send data from MoEngage to your app.
MoEngage APIs — Custom Integration (Advanced)
Full control over data flow with our REST APIs. Build any custom integration you need.Best for:
- Complex or unique use cases
- Granular control over logic
- Teams with dedicated dev resources
Detailed Comparison
| Criteria | Connected Apps | MoEngage APIs |
|---|---|---|
| Use case | Send users/events to MoEngage, or run campaigns & sync audiences from MoEngage | Highly complex or unique flows not covered by Connected Apps |
| Engineering effort | Low — config-driven, no custom backend | High — custom code, API handling, error management |
| Time to launch | Days to weeks | Weeks to months |
| Flexibility | Standardized framework with configuration options | Full granular control over every aspect |
Connected Apps: Sources vs Channels
If you’ve chosen Connected Apps, the next question is: which direction does the data flow?Connected Sources
Your platform sends data into MoEngage. Build a webhook-based integration using a JSON mapper configuration.Common use cases:
- Sync CRM contacts & profiles
- Stream form submissions & lead captures
- Track e-commerce events (orders, carts)
- Send payment/subscription events
Connected Channels
MoEngage sends data to your platform. Build a channel connector using a JSON config file uploaded in-dashboard.Common use cases:
- Send messages via your platform (SMS, chat)
- Sync audiences to ad platforms
- Push data to support/CRM tools
- Trigger actions in external systems
Step 4: Test Your Integration
A robust and reliable integration is key to a successful partnership. Thorough testing ensures a smooth experience for our mutual customers and builds trust in your solution. All testing should be conducted in your MoEngage Sandbox Workspace.Read the complete guide: Test Your Integration.
Step 5: Submit for Publishing
Once your integration is working correctly, submit it for review. The process depends on where the integration is configured:External Configuration
Setup happens on your platform. MoEngage lists your app on our marketplace with a link to your documentation for setup instructions.Example: Your platform has a “Connect to MoEngage” button and manages the auth flow.
Internal Configuration
Setup happens within MoEngage (for example, Connected Apps). MoEngage publishes the configured app to our platform after review.See the submission details in the Connected Apps guide.
Step 6: Write Your Integration Guide
Help customers understand your integration, set it up, and troubleshoot issues. A clear, well-structured guide reduces support load and increases adoption. Follow the MoEngage Partner Integration Documentation Guide to create a comprehensive help guide for your integration.Step 7: Get Listed & Promote
In addition to the in-app marketplace, MoEngage features partners on the public MoEngage App Marketplace. This is a co-marketing and lead-generation opportunity that showcases your solution to a broader audience.What you’ll need for listing
App Icon
High-resolution logo for your application.
Description
Comprehensive description of your app and use cases.
Setup Guide
Public documentation link for setup instructions.
Promote your integration
Once approved, you’ll be listed as a MoEngage partner — unlocking revenue-driving partnership opportunities. We encourage you to promote the integration to mutual customers and prospects. For ideas and resources, see Learn How to Promote Your Integration.Thank you for partnering with MoEngage!We’re excited to see the integrations you build. If you have questions at any stage, reach out to your partner manager or email [email protected].