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

# 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=1f5c6d03287c5b6c7d7b39097595a13c" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=444eb194a039afd5898592ba8f20d53f 280w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=eef57cc7f8c1ab9abb5ee625b8020f2a 560w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=1ed452a0c6e95ed9205ffd86ba5a611d 840w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=d14547c5a17199112b7a1822c1c658f2 1100w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=d9ed6a3aba5bf830e9ef7b056df55293 1650w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=94f88adb0d743dd001560dc32b577dc7 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946698644.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=55960421000599a58165c0ce06859e36" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43084946699924.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=2e1de96791ca71dd88534a3f8fe78945" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43084969575828.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=f42db9bd48fc71b7c05daa803343a6c7" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43085147292308.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=9758b3dbe3ea83300d63131eb2dcf0bd" 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/settings/support/raise-a-support-ticket-from-the-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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=9a85855fda8e75ee26eec84197b00f5e" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=646a611c4e73e9cbb98adcb454ed94c9 280w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=a4bb2ec2d42e15c02470bde831fc2385 560w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=386f6d04d2f208c139f2fdb125d7e111 840w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=e2f3666ef2c604c692b4b6e2073883d3 1100w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=0f458cce190e6b47438ed529ad9eecd5 1650w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=f073cb2e6c9d9c638f93fdf5b4a3fec6 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459000846868.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=18bfdac67918368dc2680ea494cfacb9" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=f62745b32d33cac68b223e59d4720abb" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=39d5bd4cb34b1f9959037d9bcdd1e6ff 280w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=7be0256fb616e81648e2a1236bd1b7b8 560w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=be3aaf46f20f54372d03abe0f0539706 840w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=def2927c600e6df4d45165b7e7f24ad2 1100w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=e2014e37ed7a7d58a2178cd8e27af283 1650w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=16e1716719e92aacbfc829d038b7ca39 2500w" />

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

   <img src="https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459000847636.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=6b89845389da6a22c4aa45efb8fc0645" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=5e82f14f0a282e0d417ef53619ade174" 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-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=115d3c33f75cccaa34a51f3bc49a5d16 280w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=fba64ff7b504e76fa294f7f2c53815cf 560w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=40474f778f4b69d3500138c46fbfa520 840w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=9aa31a6e3273460ce40b4e3da8a50b44 1100w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=7d1e4b1a0f243c12f7637263026c6920 1650w, https://mintcdn.com/moengage-partner-guide/t074xUYCmyVvCMyL/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=t074xUYCmyVvCMyL&q=85&s=be56ea1e9f6620954dcf6421024a9389 2500w" />

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

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