> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-docs-mcp-segmentation-tool-belt.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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=25b382dda12ebeb19c626ffa1280cdad" 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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=180b74d184c8066d56b0648681d11dbb 280w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=9c54a4e4119a415b93cbe35d22d85676 560w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=c31edd0fe3e506ed96a2b3699768ca91 840w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=25a90d5b4ac96ee1457baf92fbdff2d1 1100w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=cf30a6d748c0a1b93ef94aba33a64471 1650w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=0407316412158ada4602e76b52a99efd 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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946698644.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=e61252bf48141e9ea657b30d1b99d76f" 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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084946699924.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=4955af3d3b2aa43be5d7db531b8c470a" 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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43084969575828.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=cafb3d165163218ba44a45f59f24c1bc" 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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43085147292308.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=a1a3d98794631f0c7d1523036cb40516" 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-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=0ebda2b60e81e6fcddabb34dfc4f87f8" 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-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=b3cf6be4536fcd8521e24773f1733540 280w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=4b04dbc487249488b488a9c3a334d42b 560w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=1fe5905a53d695dc0a01423ce589e4fb 840w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=8b0a6cd354dd984bcf34cfc058134f0a 1100w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=f3adf3e1ef66db0020c134f726f09c74 1650w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=3c778e3c158a18c55ff2aa38220e3180 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-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43459000846868.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=a3042bb96a165f75f069ae79dfb0dd64" 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-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=3b1b1f9f065abc2a8370c1f88f96da5a" 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-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=33269808ea08c789108e7db6a5acff35 280w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=690bf756efd49ba99c62c9644422c20c 560w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=acf216dea2286b17dd7a8f3f9811936c 840w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=726ce0ec8a791a9d40c90e610b2b9e3f 1100w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=831585aba55220683a7fa03c72aa0200 1650w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=34a2877e3be281b316251b6821b4140f 2500w" />

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

   <img src="https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43459000847636.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=e1dd18ded40b7b7cec7fb92ab9314679" 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-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=997b0d96154cd2ad79e5f11fa4ca2bd2" 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-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=3e894209912559d6f65bd5cdab57167c 280w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=8fd83a5916e9c719e7f17b3db71495da 560w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=c2dd00d7495c4b076820d62dae36e916 840w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=ee27ff112216ad46e3941f827dc46c7f 1100w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=1e3cacd3650e3c0cd1b9ffa44d1328e1 1650w, https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/PQ4tFQPLzXwy9rm3/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=PQ4tFQPLzXwy9rm3&q=85&s=95a897006272dde07ad0a7f540182cd9 2500w" />

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

   <img src="https://mintcdn.com/moengage-docs-mcp-segmentation-tool-belt/tGh4YqLN7fmd3Led/images/partner_43459000848916.png?fit=max&auto=format&n=tGh4YqLN7fmd3Led&q=85&s=a82fddfd9ce8604b4503d901e79ded78" alt="Test MoEngage Data Track Data Extension folder" width="1596" height="590" data-path="images/partner_43459000848916.png" />
