# Integration with ADP Workforce Now (Old)

{% hint style="warning" %}
This article has been moved from its original location within the Admin Guide.
{% endhint %}

### Overview <a href="#toc109824417" id="toc109824417"></a>

MangoApps is a modern, cloud-based platform that unifies content, communication, training, and operations for the entire organization in one single platform. If you use ADP Workforce Now® to manage workforce information such as employee information, payroll, PTO requests, and scheduling, the MangoApps integration allows you to automatically synchronize your ADP Workforce Now® information with MangoApps so that this employee info is always current.

#### Features <a href="#toc109824418" id="toc109824418"></a>

* **Automatic User Profile Updates**: ADP Workforce Now® information is automatically synched when employees join the company or when they leave. This greatly reduces the potential for mistakes (such as name misspellings which can lead to duplication of user data) and the risks of accidentally assigning the wrong departments.
* **ADP Workforce Now® Virtual Assistant**: Get your PTO balance, latest pay info and shifts info on demand. Access is available without disrupting the employee’s workflow on their mobile & web dashboard.
* **Single Sign-On with ADP Workforce Now®**: Employees can use their ADP Workforce Now® login credentials and get automatically authenticated into MangoApps mobile & web apps using the out-of-the-box SSO integration.
* **Automated Team Membership**: This integration will instantly organize your employees into teams according to their profile fields using the MangoApps automation rules engine.

### Requirements and Prerequisites for System Configuration <a href="#toc109824419" id="toc109824419"></a>

* Admin Domain access.
* ADP Workforce Now® account.

### Subscriptions <a href="#toc109824420" id="toc109824420"></a>

Visit ADP Workforce Now® marketplace to get the MangoApps Data Connector [“MangoApps Connector for ADP Workforce Now®”](https://apps.adp.com/en-US/apps/348267)**.** ADP Workforce Now® will redirect to MangoApps subscription process.

* From the **Create Order** tab, Choose MangoApps plans and click **Continue.**

<figure><img src="/files/qtjuwMlfACI9eyk9AC4a" alt="" width="563"><figcaption></figcaption></figure>

* Go to the **Additional Information** tab, enter your domain URL registered with MangoApps and click **Check.**

<figure><img src="/files/Z1wcpJ2er4jDlfFVYMy4" alt="" width="563"><figcaption></figcaption></figure>

**Note:** If the domain is valid then ADP Workforce Now® will send a subscription request to MangoApps. MangoApps will read the event URL and configure the Customer domain with ADP Workforce Now® and store OOID (Account identifier). Upon completion, MangoApps will send a successful message to ADP Workforce Now®

* Once the domain validation is successful, click **Continue.**

<figure><img src="/files/mgFkpT6I6kr8MgA7FQ38" alt="" width="563"><figcaption></figcaption></figure>

* Go to **Billing Details** tab and enter the details and click **Continue.**
* Go to **Confirm Order** tab, agree to the terms and conditions and click **Place Order.**

<figure><img src="/files/oTzoB8QP5RV2n0l5oJCI" alt="" width="563"><figcaption></figcaption></figure>

* View your receipt in the Order Receipt tab.
  * MangoApps ADP Workforce Now® connector will work with existing ADP Workforce Now® and MangoApps customers.
* Go to My App from ADP **Workforce Now®** and click MangoApps application.&#x20;
* On the **Client Authorization** page, select **Allow** to provide Data connector consent and SSO Consent.
* Once the authorization is successful, you will be able to log in to the application.

Video of the subscription setup

Add and remove users from ADP

### ADP Workforce Now® Consent and Settings <a href="#toc109824421" id="toc109824421"></a>

ADP Workforce Now® admin needs to provide consent in ADP Workforce Now® portal for MangoApps to get access to ADP Workforce Now® information. Currently, MangoApps is available for ADP Workforce Now® edition. MangoApps admin has control over what information is made available to employees via MangoApps ADP Workforce Now® virtual assistant. The admin can enable one or more of the following employee self-service options in the ADP Workforce Now® virtual assistant.

* Enable My Pay
* Enable My Time Off
* Enable My Shift

<figure><img src="/files/WwS8kOsAQ3Vw4BvPstxb" alt="" width="563"><figcaption></figcaption></figure>

Graphical user interface, application Description automatically generated

### MangoApps – ADP Workforce Now® SSO Integration <a href="#toc109824422" id="toc109824422"></a>

1. User will go to My Apps where user can see MangoApps application and click on the application, user will redirect to MangoApps with account identifier (OOID).
2. MangoApps will check the account identifier (OOID) in MangoApps sever, initiate SSO process, and ask for the code from ADP Workforce Now®**.** For new customers, it will ask first for the data connector consent, and this is a one-time process.
3. User will provide consent and login (if ADP Workforce Now® session expires) and after login, ADP Workforce Now® will send authorization code to MangoApps, MangoApps will exchange token by codez-nd call for user info.
4. MangoApps will find and sync AOID in MangoApps server and based on this MangoApps will provide access to the domain.

Data connector SSO integration setup and SSO login

### Single Sign On (SSO) With ADP Workforce Now® <a href="#single-sign-on-sso-with-adp-workforce-now-r" id="single-sign-on-sso-with-adp-workforce-now-r"></a>

<figure><img src="/files/9t5rO8kpRP4sl1asqI8q" alt="" width="513"><figcaption></figcaption></figure>

As an ADP Workforce Now® customer when you subscribe to MangoApps from the ADP Workforce Now® marketplace, SSO setup will be automatically configured for your MangoApps domain. SSO features include:

* Just In Time (JIT) provisioning.
* Login via ADP Workforce Now® available on as an option on MangoApps login screen on web portal & mobile apps.

### Log In <a href="#toc109824424" id="toc109824424"></a>

To login to your Mangoapps account:

<figure><img src="/files/s9AoERIKUdUlCnp71MvI" alt="" width="563"><figcaption></figcaption></figure>

1. Enter the domain URL.
2. Select Sign in to SSO and click ADP Workforce Now®
3. On the Welcome to ADP Workforce Now® page, enter your User ID and Password.
4. Click **Sign In.**
5. Click **Allow** to provide SSO and Data Connector Consent.

You can see the MangoApps dashboard.

User login demo and some administrative notes.

#### User Provisioning and Profile Sync <a href="#toc109824425" id="toc109824425"></a>

MangoApps ADP Workforce Now® data connector will automatically import users from ADP Workforce Now® after MangoApps application is given consent in your ADP Workforce Now® admin portal. The data connector has the following capabilities:

<figure><img src="/files/z3Pdf5o82iN7D1v5KwLi" alt="" width="563"><figcaption></figcaption></figure>

* Automatically provision all users profile data from ADP Workforce Now® when the domain admin does an SSO login via ADP Workforce Now® into MangoApps.
* After user provisioning, the automatic user profile sync is done every 15 minutes so that the employee info always remains current.
* New hires/re-hires/terminations are kept in sync with ADP Workforce Now® (sync cycle every 15 minutes).
* MangoApps ADP Workforce Now® connector syncs with the following user profile information
  * First name
  * Last name
  * Manager
  * Hire date
  * Date of birth
  * Gender
  * Mobile phone
  * Email
    * Will be saved in 'alternate email address' field in MangoApps.
    * Will keep in sync on user login
  * Title
  * Office Address
  * Department
    * The department should pre-exist in MangoApps
    * Users will only be added to the department (not removed).
* When employees are removed from ADP Workforce Now®**,** they are automatically suspended by MangoApps (sync cycle every 15 minutes).

#### ADP Workforce Now® Virtual Assistant Widget <a href="#toc109824426" id="toc109824426"></a>

With the ADP **Workforce Now®** virtual assistant on their dashboard, employees don’t have to leave MangoApps to access their HR related information stored in ADP Workforce Now® Employees can:

* View their pay info.
* View their time-off details.
* View their schedule/shifts for the week.

<figure><img src="/files/ixIEZQauUF8EIlhsyHcn" alt="" width="563"><figcaption></figcaption></figure>

### Sign Out <a href="#toc109824428" id="toc109824428"></a>

1. In the top right, click the **Settings** icon.
2. Click **Sign out.**

You will be signed out from ADP Workforce Now® as well.

### User Assignment <a href="#user_assignment" id="user_assignment"></a>

1. Go to ADP Workforce Now® Marketplace and click **My Apps.**
2. Go to MangoApps App and select MangoApps from the settings.
3. Click **Assign Users.**
4. Select the users from the list and click **Next.**
5. Click **Submit.**

<figure><img src="/files/eJYIhNbwp5Q0N4MTkhjK" alt="" width="563"><figcaption></figcaption></figure>

The Manage Users tab displays the list of all users and the actions you can perform to manage the users in your domain.

### User Un-Assignment <a href="#toc109824430" id="toc109824430"></a>

1. Go to ADP Workforce No&#x77;**®** Marketplace and click **My Apps.**
2. Go to MangoApps App and select MangoApps from the settings.
3. Click **Assign Users.**
4. De-select the users from the list and click **Next.**
5. Click **Submit.**

### Cancel Subscription <a href="#toc109824431" id="toc109824431"></a>

1. Go to ADP Workforce Now® Marketplace and click **My Apps.**
2. Go to MangoApps App and select MangoApps from the settings.
3. Click **Cancel Subscription** to cancel the subscription.

By cancelling the subscription, you will no longer have access to use the application.


---

# 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-old.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.