> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-sdk-deprecated-versions-all-platforms.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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=dff41e6870c86d4371c00f90cac4b1ff" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=8c3d58c1ec6e7f248aeb3eaa6ab98a1a 280w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=e15efe6d1cc67211fe70b6b5c4b346b1 560w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=7b9a043df29ea6f67e389f4d592d11be 840w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=009059e18909386166b05d225bd1558a 1100w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=0ae5b6c1dcce05d48f1d139f5e84be30 1650w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=2652f64c2dfbc2ca424e9d22f51e0233 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946698644.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=259eb3dc216edf0b77ceb0a886e62f86" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084946699924.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=1d112ce5d53bd7a803681a2ea9f92064" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43084969575828.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=d913319a076cdc518e78a1e0ff8d00cc" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43085147292308.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=0a7b086ac8770da76711cf3c6b56e219" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=74842b793b56c5142dc9aa12f7b69c44" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=296dea623f0b1363d4e219b860264a64 280w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=1b202186281e295007da1b44996d91af 560w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=5d9f173ca77d2b53592e343a155cfc3f 840w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=5f61cb1e38fc1c394a60ba426bebb8b5 1100w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=e7957e102e07db4d22bac339b049d4c9 1650w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=21c68f168778cbb010776991d7710a02 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459000846868.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=5c544ace1ba4434841dfc8bec85b1832" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=926d7ebd0deba4900cfca79409351e67" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=fc4444f2bcdbafcc547495e343d5b57a 280w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=616bf6e3b783c204ae738ca85b2c36ab 560w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=d108ccdbb4cfe922d1a2eca3217913b8 840w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=30b083accdc50a3654a0c38b6e53d7f6 1100w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=a7463f3171ef4d7a400b586eec1791bf 1650w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=2015b7d18067e3b6547f3de6cc0ad5a6 2500w" />

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

   <img src="https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459000847636.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=1fafcaf67dfef0de490c8372d11b66ab" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=80406d9abd3b40aa8332cf1f994c609d" 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-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=88d0df8afac97041ee0e6386c8381d12 280w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=747ea602644a497b45b1ac24d6ec75f9 560w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=2b4384a83c755f490685e3e52a7d6c41 840w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=001ffcddaca52dcfce14bd722273f8d9 1100w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=5ec637a6176430a81eb8ffdcf90fa6e4 1650w, https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=ae4227854df3fc5fd27a107b38b21aa8 2500w" />

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

   <img src="https://mintcdn.com/moengage-sdk-deprecated-versions-all-platforms/rI8fwNv_nIoNEoXX/images/partner_43459000848916.png?fit=max&auto=format&n=rI8fwNv_nIoNEoXX&q=85&s=8ad535fc8495f35e2f5918acf7e02105" alt="Test MoEngage Data Track Data Extension folder" width="1596" height="590" data-path="images/partner_43459000848916.png" />
