# mParticle integration

<Aside type="caution" icon="setting" title="Developer assistance needed">
 You'll need help from your development team to set up the integration. Please share this guide with them.
</Aside>

## Integration overview

[mParticle](https://www.mparticle.com/) is a platform for managing customer data collected from mobile apps, web, and other sources.

If you use mParticle to store customer data, you can easily set up integration with Pushwoosh. This will allow you to create targeted, personalized, and effective campaigns in Pushwoosh using data from mParticle.

You can send the following data from mParticle to Pushwoosh:

* **User attributes**: name, location, device, preferences, behavior, etc. This data will be saved in Pushwoosh as [Tags](/product/audience-data-and-segmentation/user-data-tags/tags/) and their values for each user. The data type for each Tag is identified automatically.
* **Events**: each Event configured in mParticle will be transferred to Pushwoosh and saved as the [Event](/product/audience-data-and-segmentation/events/default-events/) with the same name and tags if there are any. Pushwoosh will also get information about which Events each user has triggered.
* **Segments**: all mParticle Audiences based on user attributes and triggered Events can be transferred to Pushwoosh as Segments. You can use them to create highly targeted campaigns. If an Audience segment is updated in mParticle, that segment will also be updated in Pushwoosh. The update frequency of mParticle segments is configured on the mParticle side.

<Aside type="note">
Please note that Tags and Events in mParticle should not be named the same as the default Tags and Events in Pushwoosh. If the names match, the data may not be transmitted.
</Aside>

The data is not transferred back from Pushwoosh to mParticle, but we plan to add this option in the future, so stay tuned.

## Setting up integration

<Aside type="note">
To set up mParticle and Pushwoosh integration, you do not need to integrate the Pushwoosh SDK into your app. This is only required if you create campaigns that include in-app messages.
</Aside>

1. [In the mParticle interface](https://app.mparticle.com/login), go to the **Directory** section and find **Pushwoosh** in the list. Hover over the icon and click **Setup**.

<img src="/integrations-mparticle-integration-1.webp" alt="Finding Pushwoosh in mParticle Directory"/>

2. Select both **Event** and **Audience** Outputs and click **Configure**:

<img src="/integrations-mparticle-integration-2.webp" alt="Selecting Event and Audience Outputs in mParticle" width="375"/>

3. On the page that opens (**Setup** → **Outputs**), click on the plus icon in the **Pushwoosh Default Group** row:

<img src="/integrations-mparticle-integration-3.webp" alt="Pushwoosh Default Group in mParticle Outputs"/>

Insert any configuration name (for example, _Pushwoosh integration_), the Pushwoosh application code, and the API key. Click **Save**.

<details>

<summary>Where can I find the application code and API key?</summary>

You can find the application code at the top left corner of the Pushwoosh interface, right below the project name:

<img src="/integrations-mparticle-integration-4.webp" alt="Finding application code in Pushwoosh interface" data-size="original"/>

To find the API key, go to **Settings** → **API Access**:

<img src="/integrations-mparticle-integration-5.webp" alt="API Access section in Pushwoosh settings" data-size="original"/>

</details>

<img src="/integrations-mparticle-integration-6.webp" alt="Configuration settings for Pushwoosh integration" width="375"/>

Now switch to the **Audience** tab and repeat these steps for the **Pushwoosh Default** row:

<img src="/integrations-mparticle-integration-7.webp" alt="Audience tab configuration in mParticle"/>

4. Go to **Connections** → **Connect** and click on the Input you want to integrate with Pushwoosh.

<img src="/integrations-mparticle-integration-8.webp" alt="Connections section in mParticle interface"/>

Click **Connect Output**, select **Pushwoosh**, and activate the connection.

<img src="/integrations-mparticle-integration-9.webp" alt="Connecting Pushwoosh output in mParticle"/>

Repeat these steps for each Input you want to integrate with Pushwoosh.

If everything is configured correctly, Pushwoosh will start receiving data from mParticle, and you will be able to create [customer journeys](/product/customer-journey/pushwoosh-journey-overview) and send [push notifications](/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/) using customer data from mParticle.