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.
Β 

arrow_drop_downπŸ“₯ 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.

Ideal for CRMs, CDPs, e-commerce platforms, form tools, and any system that collects user data.

arrow_drop_downπŸ“€ 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.

Ideal for analytics platforms, data warehouses, and BI tools that need MoEngage engagement data.

arrow_drop_downπŸ“£ 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.

Ideal for messaging platforms, ad networks, creative tools, and marketing automation systems.

arrow_drop_downπŸ”„ Enrich & Personalize β€” Fetch real-time data or create dynamic content

Ideal for recommendation engines, content management systems, and personalization platforms.

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

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

πŸ’‘ 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 partnerships@moengage.com.

Previous

Next

Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?