> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-gr001-flows-limits.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Send events from MoEngage to SFMC

> Use MoEngage Streams to send campaign interaction events to Salesforce Marketing Cloud Data Extensions for segmentation, personalization, and journey decisioning.

## Integration

<Info>
  **Prerequisites**

  * Follow the steps mentioned in [Set up MoEngage activity in SFMC](/partner-guide/message-orchestration/marketing-cloud/salesforce-marketing-cloud-sfmc/setup-moengage-activity) to set up the MoEngage Custom Activities on Salesforce Marketing Cloud.
  * This is a part of the Streams add-on. Please reach out to your dedicated MoEngage CSM (customer success manager) to get it enabled for your account.
</Info>

### Step 1: Set up Streams on SFMC

To set up streams on SFMC, perform the following steps:

1. Go to the "Homepage".

2. Click on "Web Studio", and then click on "CloudPages".

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=6454a3b2b293f66cdf232f5fc4c0e5bc" alt="Navigating to Web Studio > CloudPages in SFMC" data-og-width="1146" width="1146" data-og-height="616" height="616" data-path="images/partner_43084946697620.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=1c11fa979cabdb166663dc9b5e177928 280w, https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=57007a7af43bd9fd82d3cf8c8a8af8f2 560w, https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=ecc2688aa5621909cf039ec6be9d67ac 840w, https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=e2d55a6d959e8b03ae41f4f4ff11bbe0 1100w, https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=3a52a101e216e7b21658f61af94b905b 1650w, https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=eb38817a8143b27ebe11fe5c7fb05049 2500w" />

3. Click on "CloudPages", then on "MoEngage Credentials" subfolder and finally on "MoEngage Workspace and Data Tracking Credentials".

4. Click on the "arrow" to open the dropdown list and then click on "Edit".

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946698644.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=a58a398e6f9cf3cb090be27a26d8d935" alt="Edit option from the dropdown list on the CloudPage" width="1150" height="670" data-path="images/partner_43084946698644.png" />

5. Click on the "Page URL" to open the Authentication Page.

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084946699924.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=5101218f1f88200480411fec1e13e049" alt="Opening the Page URL to access the Authentication Page" width="1050" height="584" data-path="images/partner_43084946699924.png" />

6. Select the "Data Center", then enter the "Workspace Name", "Workspace ID", "Data API Key", and "Campaign/Push API Key" from the MoEngage Platform.

7. Click on "Submit" once all the details are filled.

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43084969575828.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=8beb214661d48c68df83cb286ef9b539" alt="Submitting MoEngage workspace credentials in SFMC CloudPage" width="1048" height="484" data-path="images/partner_43084969575828.png" />

8. After submitting the credentials, they will be validated with MoEngage and securely encrypted before being stored in the **Credentials Data Extension**.

9. The second part of the CloudPage focuses on **Data Tracking Credentials**.

10. Please enter your desired **Username** and **Password** for data tracking. This information will be required when raising a support ticket with MoEngage Streams.

    <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43085147292308.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=df1349bdc9fe3f8d8bd26440adaf0ca7" alt="Entering Username and Password for Data Tracking credentials" width="396" height="320" data-path="images/partner_43085147292308.png" />

11. Ensure you remember the password you enter, as it will be encrypted and stored in the **Data Tracking Data Extension** and cannot be retrieved in plain text later.

### Step 2: Set up Streams on MoEngage

To create a [support ticket](/user-guide/contact-support/raise-a-support-ticket-through-moengage-dashboard) with MoEngage, share the following details:

* **Username**: This is the unique identifier assigned to your MoEngage account, used for authentication purposes.
* **Password**: The unencrypted password entered in the **CloudPage**. Although the password is encrypted and stored in the **Data Extension** for security, the unencrypted version is required when raising the support ticket.
* **URL**: The URL of the published MoEngage Campaign Tracking **CloudPage**.

Ensure all information is accurate before sharing it with MoEngage Support.

### Step 3: Activate Streams Data Simplification Automation on SFMC

This process converts the raw event data MoEngage sends into a structured, usable format for SFMC segmentation, personalization, and journey creation.

#### Automation function

The automation performs the following key functions:

* It reads new rows from the Raw MoEngage Data Track Data Extension.
* It parses and simplifies the nested event data JSON.
* It writes the processed records into the final MoEngage Data Track Data Extension.
* It marks the original raw records as processed to prevent data duplication in subsequent runs.

#### Activation steps

To enable the data simplification process in SFMC, perform the following steps:

1. Go to "Automations" and navigate to the "MoEngage-SFMC" folder.

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=77c95364ce9c9356db0784a31fa73d41" alt="Navigating to Automations > MoEngage-SFMC folder in SFMC" data-og-width="1364" width="1364" data-og-height="726" height="726" data-path="images/partner_43459030334996.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=387f2b8269c25933ec64865d08e0a3a3 280w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=4818f4224094e6906bdbd4c94b73427d 560w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=d26c8f3a9f1495bf94cfb10b0ad0b451 840w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=8416c9082818ac3f768527913a51b9c6 1100w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=5b609ec3c2790fea9c47247301177250 1650w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=ae998ca247bfb965a1b3ae60a2df8ae6 2500w" />

2. Navigate to the Automations tab and open the designated "MoEngage-SFMC" folder.

3. Locate the automation named "MoEngage Streams Data Simplification".

   <Note>
     This automation must be scheduled no more frequently than once every 15 minutes to ensure optimal performance and avoid throttling SFMC resources. A 30-minute or hourly schedule is generally recommended. You can also run it on demand.
   </Note>

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43459000846868.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=9cdcaca8d80c6ae00a571768dc558fea" alt="MoEngage Streams Data Simplification automation in the folder" width="1578" height="552" data-path="images/partner_43459000846868.png" />

### Step 4: Verify configuration

To verify the configuration, perform the following steps:

1. Confirm all required fields are correctly filled in the **MoEngage Tracking Credentials Data Extension**.
2. Verify that the MoEngage Support team has received the required credentials and that the campaign tracking setup is complete.
3. After MoEngage Streams is configured, interaction data will be sent to the specified **CloudPage** if the **Event Name** is included in the Streams config.
4. Make sure the **Test MoEngage Data Track** Data Extension is set up, so it receives test tracking data from **Streams** via the **CloudPage**.
5. Ensure the **MoEngage Streams Data Simplification** automation is active.
6. Confirm that the **MoEngage Data Track Data Extension** is properly configured and accessible.

### Step 5: View Streams data in SFMC

This section helps you validate that events sent from MoEngage are successfully processed within your SFMC Data Extensions.

#### Simplified Data Target: MoEngage Data Track DE (Data Extension)

This Data Extension stores a simplified version of event data after it has been parsed and processed by the MoEngage Streams Data Simplification automation. Use this Data Extension in your Journey Builder for personalization, decision-making, and so on.

To access the MoEngage Data Track Data Extension, perform the following steps:

1. Go to "Data Extensions" and navigate to the "MoEngage Data Track" folder.

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=f17d69c7e61731969c26f826b89f9be0" alt="Navigating to Data Extensions > MoEngage Data Track folder" data-og-width="1574" width="1574" data-og-height="754" height="754" data-path="images/partner_43459030335380.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=4541ae850c568367b7acade32993c8dc 280w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=99f685d5804e61b8e14130790a1c614f 560w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=d97301cbf771a41ce6eb3ff39ca8af7a 840w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=69c6a33db338a920022ab6b66bad9959 1100w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=c26e0e9a3734efc536545414b26eba6a 1650w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=7c1cbe52ea95c68a73dfe3aa5eed5191 2500w" />

2. Locate the Data Extension folder named "MoEngage Data Track".

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43459000847636.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=be30920b1551c6ad41df94471cab9607" alt="MoEngage Data Track Data Extension folder" width="1572" height="606" data-path="images/partner_43459000847636.png" />

#### Raw Event Storage: Test MoEngage Data Track DE (Data Extension)

This Data Extension stores the raw event data exactly as received from the MoEngage Streams HTTP POST payload captured in JSON format.

To test the MoEngage Data Track Data Extension (DE), perform the following steps:

1. Go to "Data Extensions", then select "MoEngage Data Track".

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=9785fc5c8bc18d6cb35a4a4d6ae5d09d" alt="Navigating to Data Extensions > MoEngage Data Track for testing" data-og-width="1366" width="1366" data-og-height="710" height="710" data-path="images/partner_43459030335892.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=93d73a3720f97bfe3e3a38511d20d9f7 280w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=100ce10b4afb049ab047fbe64a0eb891 560w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=afb443ca6fd468154d7388096ce51c37 840w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=712a75e80a146b36df1abd9e751bc5f4 1100w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=00fbef32eaa779940fe3bd93c78bc604 1650w, https://mintcdn.com/moengage-gr001-flows-limits/qDXO60Nn6kPbQGNg/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=qDXO60Nn6kPbQGNg&q=85&s=25ea1f53a81fbc0307dfeeb9488f3952 2500w" />

2. Locate the Data Extension folder named "Test MoEngage Data Track".

   <img src="https://mintcdn.com/moengage-gr001-flows-limits/4xsRF7zfuAG1nPmc/images/partner_43459000848916.png?fit=max&auto=format&n=4xsRF7zfuAG1nPmc&q=85&s=a0c6bc3a5e8d18cade5217ff321ee4ab" alt="Test MoEngage Data Track Data Extension folder" width="1596" height="590" data-path="images/partner_43459000848916.png" />
