> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-analytics-query-api-docs.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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=53ed740075307cf15df76c1622870ee3" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=dba1f23d5daf0fd0c3a241a4b85faf99 280w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=cc14bdba493ef6bc0544b5c1af0e807c 560w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=fef86b7fcad050826e64fbcb3d61e49d 840w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=810a693835de71b5a1bec855eb45d828 1100w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=c6480cc822a6238a4fb6e6ae009fa7dc 1650w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=48ac35d0564160d8151ed92e11cf426c 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946698644.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=7da94f1d4c83fc404bcdb2b983643e6f" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084946699924.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=a5088169fd9dff28918551178a6f84b8" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43084969575828.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=641ffa79e13eb42488fcfdfe939accf8" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43085147292308.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=275f86113fe7152a84ca4b91443aa9fb" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=29d37188d1f726ec24ccd513db6d77c7" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=82a68ccc9d584489190e94f2b641f2bd 280w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=5f6905ec632885e264b73e547068b69b 560w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=3265fea68736b4cf78c5944ae4047ea7 840w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=26e04dbe23cf436ddbcb8fc599b67bd4 1100w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=c735f9e7d925235ee8dd320440e89ee0 1650w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=abbd2f95036d8d1c2988ba1f62c69297 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459000846868.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=8e99ed0349c5e59f4be767d01df276e9" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=fa5494faec12b6369a31fab8ed3cb4a1" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=38ab664142ca26ec2468f2a1d0461263 280w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=544575bbb708a0daada4671543b58958 560w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=4d6b72442b26509ab7110f8591793865 840w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=1234e0eae2f9448c7105f8f2965af76d 1100w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=1446ecf58688334ab811b43f849b2804 1650w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=4c193c8c194fc371596870406f648f25 2500w" />

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

   <img src="https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459000847636.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=950fcb68b640c41bf111fcf4573f7f91" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=8509b4b45d5e7ac0c3f1f6acd85f35a7" 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-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=6fb7059ffc92ed90716583d9b8107c32 280w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=da628b20a837dc981a58f14b4deadf1d 560w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=a30e566240f70466c729636d617e1ac0 840w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=98ecf89150c85acccd22144c12a0c346 1100w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=0b12d6d17545c9cd583a681d56a9fae5 1650w, https://mintcdn.com/moengage-analytics-query-api-docs/EtqWM20TduLjcrl1/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=EtqWM20TduLjcrl1&q=85&s=2f5beb1946129831d5ab7792afe0bb8d 2500w" />

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

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