Getting started

Welcome, Partner! 👋 This guide is your roadmap to building, testing, and publishing an integration on the MoEngage App Marketplace. Follow the steps below from start to finish — or jump to the section that matches where you are in the process.

1. Explore
2. Sandbox
3. Build
4. Test
5. Submit
6. Document
7. Launch

---

​

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. Learn more → 📋 Guidelines Best practices and requirements for building a robust integration. Read guidelines → 📖 Key Concepts Glossary of terms and concepts you’ll encounter throughout. View glossary →

​

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. For a complete overview of all supported patterns, see Possible Use Cases.

​

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 Sandbox Follow 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. 🧭 Which path is right for you? Start with what your integration needs to do. ⚡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

💡 Recommendation: Start with Connected Apps for all supported use cases. It’s faster, simpler, and covers the vast majority of integration patterns. Only choose the API route if your use case genuinely requires it.

​

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

Build with Connected Sources → ↑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

Build with Connected Channels →

​

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 (e.g., Connected Apps). We publish the configured app to our platform after review. See the submission details in the Connected Apps guide. 📝 Include with your submission: End-to-end test instructions, access to your platform for verification, and confirmation that data flow and campaigns are working as expected.

​

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, we feature 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 📋 Read the full guide: List as a Partner 📝 Submit your listing: Partner Listing Submission Form

​

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: Learn How to Promote Your Integration

---

🎉 Thank you for partnering with MoEngage! We’re excited to see the amazing integrations you build. If you have questions at any stage, reach out to your partner manager or email [email protected].