# Synchronize Users From ADP

### Overview

MangoApps provides three options for synchronizing employee profiles from ADP to MangoApps:

1. **Manual Import** – Upload an exported Employee profile CSV from ADP.
2. **Automated SFTP Sync** – Schedule an ADP export and sync it via SFTP.
3. **MangoApps Connector for ADP** – Utilize a real-time API-based integration.

***

### Importing Manually Exported Employee Profile CSV from ADP

Follow these steps to manually import employee profiles.

#### **On ADP Side**

1. Create a **New Customer Report** in ADP.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FB8ogyPXhoXgw96GsvzZB%2Fimage.png?alt=media&#x26;token=f9aa3748-d30b-4cd7-bdba-53b350c7ec1a" alt="" width="368"><figcaption></figcaption></figure>

2. Select **Employee or Contract Profile Data**.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FU7YVTnatihnrfyfMJW95%2Fimage.png?alt=media&#x26;token=3af90a6c-de14-4207-95d0-6fec613cf190" alt="" width="370"><figcaption></figcaption></figure>

3. In the **Build Your Report** screen:

* Select required fields.
* Apply any necessary filters.
* Provide a report title and description.
* Run the report.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FumK3ZbyhZFhxPuyv9rJk%2Fimage.png?alt=media&#x26;token=c3d88b39-6958-46ca-a5c0-71923da0a26f" alt="" width="368"><figcaption></figcaption></figure>

4. Save the report in **CSV format**.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2F9EEbBqKJXVm5r1s4Xcgc%2Fimage.png?alt=media&#x26;token=97cf460c-6fe2-4bec-a796-d545bf06923e" alt="" width="368"><figcaption></figcaption></figure>

***

#### **On MangoApps Side**

1. Log in to your **MangoApps domain** and switch to the **Admin Portal**. Navigate to **Import Users**.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FTs73wHwdp0wv9ON5x8WC%2Fimage.png?alt=media&#x26;token=3512694d-3ada-4689-87c7-ef93d9905907" alt="" width="536"><figcaption></figcaption></figure>

2. Browse and select the **CSV file** exported from ADP.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FYqUQXKnZ3rp6usL3BeyZ%2Fimage.png?alt=media&#x26;token=6fbbc480-8c62-4d71-9ee9-7dc435fecbbd" alt="" width="521"><figcaption></figcaption></figure>

3. Click **Import Now** to load users from the CSV into MangoApps.

***

### Automating SFTP Sync for Scheduled ADP Exported CSV

Use the following steps to automate user synchronization using an SFTP sync.

#### **On ADP Side**

1. Request **SFTP Export** from the ADP Reporting module.
2. Set up an **SFTP server** to pull reports.
3. Contact your **ADP account representative** to initiate the setup process. There is a **one-time fee** for this setup.
4. Build reports in ADP and configure them for **SFTP delivery**.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FyyAr5JSVXLUc1Y3Thq5J%2Fimage.png?alt=media&#x26;token=8b6ec4d8-6095-41b8-a913-3cb27d824f58" alt="" width="563"><figcaption></figcaption></figure>

***

#### **On MangoApps Side**

1. Once the SFTP export configuration is complete in ADP, log in to the **MangoApps Admin Portal**.
2. Configure the **SFTP settings** in MangoApps to automate the sync.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FFKSUkCBYZj6xID3uLRvc%2Fimage.png?alt=media&#x26;token=cd2ae4fa-b877-41bd-a4dd-54c32337ea02" alt="" width="563"><figcaption></figcaption></figure>

3. Set a **sync schedule** in MangoApps that aligns with the ADP export schedule.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FZslx3o4aqH6ZLNybMSwg%2Fimage.png?alt=media&#x26;token=03ea39e6-2e4e-4c51-b38a-732a2719eca3" alt="" width="563"><figcaption></figcaption></figure>

***

### MangoApps Connector for ADP (Real-Time API Integration)

For real-time synchronization, MangoApps offers an API-based integration with ADP.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FXUBRV4IFMGOtzW24tSX4%2Fimage.png?alt=media&#x26;token=2cb60f4f-443c-4027-82b0-5584b99e08c1" alt=""><figcaption></figcaption></figure>

#### **Enabling the Connector**

1. Purchase the [**MangoApps Connector for ADP**](https://guides.mangoapps.com/integrations-guide/single-sign-on/integration-with-adp-workforce-now) from the [**ADP Marketplace**](https://apps.adp.com/en-US/apps/348267).
2. ADP applies a **monthly per-user fee** for this service.
3. Contact your **ADP account manager** for pricing and implementation details.

***

By choosing the appropriate synchronization method, you can ensure that employee data remains up to date within MangoApps, improving efficiency and user management across your organization.