> ## Documentation Index > Fetch the complete documentation index at: https://moengage-partner-guide.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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 β†’](/partner-guide/integrate-with-us/1-foundations/app-marketplace) πŸ“‹ Guidelines Best practices and requirements for building a robust integration. [Read guidelines β†’](/partner-guide/integrate-with-us/1-foundations/guidelines) πŸ“– Key Concepts Glossary of terms and concepts you'll encounter throughout. [View glossary β†’](/partner-guide/integrate-with-us/1-foundations/key-concepts) ### 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 User Data**](/partner-guide/integrate-with-us/2-explore-capabilities/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. * [**Receive Data**](/partner-guide/integrate-with-us/2-explore-capabilities/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. * [**Trigger Campaigns**](/partner-guide/integrate-with-us/2-explore-capabilities/trigger-campaigns): Initiate marketing campaigns in MoEngage based on actions in your application. * [**Use External Creatives**](/partner-guide/integrate-with-us/2-explore-capabilities/use-external-creatives-in-campaigns): 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. * [**Dynamically Fetch Data**](/partner-guide/integrate-with-us/2-explore-capabilities/dynamically-fetch-data): Enrich MoEngage campaigns with real-time data from your application. * [**Create Content Creatives**](/partner-guide/integrate-with-us/2-explore-capabilities/create-content-creatives): Enable the creation of dynamic, personalized content for use in campaigns. Ideal for recommendation engines, content management systems, and personalization platforms. For a complete overview of all supported patterns, see [**Possible Use Cases**](https://moengage.com/docs/partner-guide/integrate-with-us/2-explore-capabilities/integration-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**](/partner-guide/integrate-with-us/1-foundations/account-setup) 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 β†’](/partner-guide/integrate-with-us/3-build-integration/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 β†’](/partner-guide/integrate-with-us/3-build-integration/connected-apps#h_01K5XEAWAX2F30222QSH6T69ZH) ## 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**](/partner-guide/integrate-with-us/3-build-integration/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**](/partner-guide/integrate-with-us/3-build-integration/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**](/partner-guide/integrate-with-us/4-moengage-partner-integration-documentation-guide/writing-guide/getting-started) 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**](https://www.moengage.com/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**](/partner-guide/integrate-with-us/5-publish-integration/list-as-a-partner) πŸ“ Submit your listing: [**Partner Listing Submission Form**](https://forms.gle/bzPwoXQEx6bFGNyj6) ### 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**](/partner-guide/integrate-with-us/5-publish-integration/promote-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](mailto:partnerships@moengage.com).