# Integration with ADP Workforce Now®

### Overview

MangoApps is a modern, cloud-based platform that unifies content, communication, training, and operations into a single workspace. By integrating MangoApps with ADP Workforce Now®, organizations can streamline workforce management by enabling single sign-on (SSO), automatic user provisioning, and real-time employee data sync—ensuring that MangoApps always reflects the most current ADP data.

***

### Required Roles

To configure the ADP Workforce Now® SSO integration with MangoApps, specific administrative roles are required on both platforms:

* **ADP Workforce Now® Admin Access**: Required to purchase the MangoApps Connector, grant necessary consents, and manage user assignments.
* **MangoApps Domain Admin Access**: Required to complete the domain setup, configure sync rules, and manage user roles and permissions.\
  Both admin roles must coordinate closely to ensure seamless integration and maintenance.

***

### **ADP Workforce Now®** Side Setup

To begin setting up the integration, first navigate to the **ADP Workforce Now® Marketplace**.

#### **Subscribe to MangoApps Connector**

Search the Marketplace and select the **MangoApps Connector for ADP Workforce Now®**.

On the **Create Order** tab, choose a MangoApps plan and continue.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FGVFClNu7SxfoEqYI4ehh%2Faewrgaeres.png?alt=media&#x26;token=d83acc8d-164c-4598-8b21-1b3f54e41340" alt="" width="563"><figcaption></figcaption></figure>

Enter your MangoApps domain URL under **Additional Information** and validate it by clicking the **Check** button.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F29No4VNu3Rzku0lZTpVt%2Ferhretherthder.png?alt=media&#x26;token=a5edd0b4-3126-4fd5-80ef-17bdff4e2bb1" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
If the domain is valid, ADP Workforce Now® will send a subscription request to MangoApps. MangoApps will then read the event URL, configure the customer domain with ADP Workforce Now®, and store the OOID (account identifier). Once this process is complete, MangoApps will send a success confirmation back to ADP Workforce Now®.
{% endhint %}

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FnMhXK8aAVZOhGQlE5wxd%2Fehrtherteh.png?alt=media&#x26;token=61917773-1fc3-42bc-9cec-cc2dc96a2046" alt="" width="563"><figcaption></figcaption></figure>

Complete the billing and confirmation steps to place the order.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FzjWuQRyVSzC6ShbWVNCp%2Frthsrthre.png?alt=media&#x26;token=da63312c-ba42-4251-ac42-44b1f3bf94e9" alt="" width="563"><figcaption></figcaption></figure>

***

#### **Grant Required Consents**

Navigate to **My Apps** in ADP Workforce Now®.

Launch the **MangoApps App** and on the **Client Authorization** screen, click **Allow** to give consent for data connector and SSO.

**Assign Users**:

Go to the MangoApps app settings in ADP Workforce Now®. The **Users** tab displays the list of all users and the actions you can perform to manage the users in your domain.

Click **Assign Users**, select employees, and submit the assignment.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FZIEjp283jdoyYf8YHjgj%2Frthjrtyjrty.png?alt=media&#x26;token=896a568d-f0c1-47a9-ada7-ad3073b96114" alt=""><figcaption></figcaption></figure>

Users can also be unassigned from the same menu by simply deselecting them from the user list.

***

### MangoApps Side Setup

Once the subscription and consent process is complete in ADP, we will navigate to the MangoApps Admin Portal.

#### **Domain Configuration**

The platform initiates the configuration and stores the identifier for future SSO checks.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FeYvgFqgOWXfovB880PfN%2F09-06-2025-11-40-25.png?alt=media&#x26;token=418f2092-78ce-4473-91b1-b51ad1161747" alt="" width="563"><figcaption></figcaption></figure>

MangoApps automatically receives the domain and OOID (account identifier) from ADP for the configuration.

***

#### **SSO Integration**

MangoApps will recognize users accessing from the ADP Workforce Now® SSO.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FkZZnjIp3cRPLpWyDakBD%2F09-06-2025-12-00-49.png?alt=media&#x26;token=ca756e85-221a-4814-afe4-ab8de848cb23" alt="" width="563"><figcaption></figcaption></figure>

For new customers, data connector consent is a one-time setup step.

When signing out of MangoApps, the user will be signed out from ADP Workforce Now® as well.

***

#### **Profile Sync & Provisioning**

Upon successful domain validation, user profiles are provisioned via Just-In-Time (JIT) provisioning.

{% hint style="warning" %}
A Note on Synched Fields:

Email

* Will be saved in 'alternate email address' field in MangoApps.
* Will keep in sync on user login.

Department

* The department should pre-exist in MangoApps.
* Users will only be **added** to the department (**not removed**).
  {% endhint %}

MangoApps syncs user data every 15 minutes, including new hires, terminations, and profile changes.

***

### Canceling Subscription

If, for any reason, you wish to cancel your subscription, go to the ADP Workforce Now® Marketplace and click on **My Apps**.

From the list, select **MangoApps** and open its settings. Then, click **Cancel Subscription**.&#x20;

Please note that cancelling the subscription will remove your access to the MangoApps ADP application.

***

### Testing Considerations

Before rolling out to the broader organization, admins should:

* Test login via **ADP Workforce Now® SSO** on both web and mobile platforms.
* Validate that user profile fields are correctly synced (e.g., name, title, department).
* Ensure team membership automation is functioning as expected.
* Test the ADP Workforce Now® Virtual Assistant widget to confirm access to pay, PTO, and shift information.

***

### Security Considerations

Security and data integrity are prioritized in this integration:

* **OAuth 2.0 Protocol** is used for token-based authorization.
* **SSO Consent** ensures no user credentials are stored in MangoApps.
* **Automatic Suspension** of users upon termination from ADP Workforce Now® prevents unauthorized access.
* Admins control what employee data is exposed through the ADP Virtual Assistant.

***

### End User Experience

Employees benefit from a seamless, secure login experience.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FIubJHeLQwUZUEQwLIQbb%2Fdtmtdmutyf.png?alt=media&#x26;token=b718a7eb-8811-4f7f-8d7a-c1795480be8d" alt="" width="563"><figcaption></figcaption></figure>

Navigate to the MangoApps login screen and select **Sign in with ADP Workforce Now®**. Enter ADP credentials and provide one-time consent.

After authentication, users are redirected into their MangoApps dashboard.

Users are automatically organized into teams and departments based on ADP data. When employees are removed from ADP, they are also suspended in MangoApps to maintain security.

ADP can also be added to the **My Enterprise Apps** menu.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F3AIK8Rx8LyvN89DxRddq%2F09-06-2025-02-04-42.png?alt=media&#x26;token=a753d444-778a-49b0-9995-813ec5ff199a" alt="" width="563"><figcaption></figcaption></figure>

Once SSO is set up, the application will appear under the **Admin Portal > SSO > Applications**. From there, you can toggle it on to make it visible in the **My Enterprise Apps** menu—provided it's also enabled in the MangoApps admin portal.

To enable it in the admin portal:\
Go to **Navigation > \[Selected User Navigation Group] > Top Right Section > My Enterprise Apps**, then click the gear icon and ensure **MangoApps** is selected and the toggle is enabled.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2Fr90ONmbM3aTb48VkH9GR%2F09-06-2025-02-11-51.png?alt=media&#x26;token=dc69af21-5531-4762-940c-4d9068823775" alt="" width="563"><figcaption></figcaption></figure>

***

### Rollout Recommendations

To ensure a smooth deployment:

* **Start with a Pilot Group**: Assign the integration to a limited group of users to identify potential issues.
* **Train Admins and Support Teams**: Ensure both ADP and MangoApps admins are familiar with setup, user assignment, and support flows.
* **Communicate with End Users**: Provide guidance on how to log in via ADP SSO and use the virtual assistant features.
* **Monitor Sync Logs and Errors**: Regularly review user provisioning logs to catch sync or access issues early.
* **Scale Gradually**: Expand to the rest of the organization once the pilot is successful and stable.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/integrations-guide/single-sign-on/sso-integrations-by-provider/sso-integrations-for-adp-workforce-now/integration-with-adp-workforce-now-r.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.