ADP Integration - Enable the ADP Employee Sync

Enable the ADP Employee Sync

Once an edition of the Litmos app has been purchased from the ADP Marketplace, an ADP administrator can enable the ADP Employee Sync. However, before the Employee Sync can be enabled in Litmos the ADP administrator must give Litmos consent to acquire employee information from ADP. This can be completed in two ways:

a) Access the "Connection Request" email that was sent to the ADP administrator's inbox when the Litmos app was purchased from the ADP Marketplace, and click "Initiate Consent".

b) Log into ADP to access the Consent Manager List and grant consent to Litmos LMS. Litmos will move into the "Allowed Consents" section once this is completed.

Consent Manager List:


NOTE: Once the ADP Admin has given consent to share employee information with Litmos LMS, the ADP Administrator will need to cross-reference the following information before performing the first ADP Employee Data Sync into Litmos:


IMPORTANT NOTE: The ADP Employee sync has been designed to have the ADP work email field value transfer into Litmos as the Litmos username for individuals. Therefore, it is important to make sure that your employees in ADP have a work email address, and that this work email address matches the existing Litmos username for any person who already exists as a Learner in Litmos before the 1st ADP employee sync is performed.

If the work email field in ADP is blank for certain individuals, or perhaps this field is empty or cannot be shared via the API, then the ADP Associate ID field value will be used as the Litmos username instead. Similarly, please ensure that the ADP Associate ID field value matches an existing Litmos username if your employees do not have work email addresses on employee records in ADP.



To proceed with enabling the ADP Employee Sync, a Litmos Account Owner will log into Litmos and access the "Integrations" tab within the "Account" tab. The ADP integration listing can be accessed under the "3rd Party Integrations" section.



Here, the ADP administrator will click on the ADP listing to open a new pop-up window. The "Enable Employee Sync" option will display in this window.

WARNING: Before activating the ADP employee sync, it is important to cross-reference employees in ADP with existing Litmos profiles to ensure that ADP employee records will properly sync up with existing Litmos profiles that may have been created directly in Litmos or via single-sign on from the ADP Marketplace.



Once "Enable Employee Sync" is checked and the "Save Changes" button is clicked, another pop-up will display reading,

"The ADP Employee Sync is now enabled. Please click "OK" to initiate the employee sync process".

This means that clicking "OK" will trigger the first ADP employee sync to Litmos. In this initial sync, all ADP employees will be created in Litmos and all applicable ADP employee information will be updated for each employee that was just created in Litmos.

When the sync is processing, a new "syncing" spinner will appear along with a new "Sync ADP Data Now" button.



At this time, the "Sync ADP Data Now" button will be unavailable to use because the initial sync is processing. Once the initial sync has finished processing, the "Sync ADP Data Now" button can be used by Litmos Account Owners moving forward. When this button is clicked, Litmos will perform a real-time sync with ADP to find employees to create in Litmos, and update information in Litmos that has changed for synced employees.

The "Sync ADP Data Now" button should only be used when Litmos needs to retrieve new ADP employees and updated ADP employee information immediately. Otherwise, an employee sync will occur once-a-day automatically so that Litmos Account Owners do not have to repeatedly execute manual syncs.

IMPORTANT NOTE: All ADP employees are created in Litmos, even terminated and inactive employees. These individuals will be created in Litmos as "inactive" Learners and will not have login access and will not receive notifications.

Here is the complete list of the ADP information that can be updated in Litmos for each Learner during each system sync. It is important to recognize the significance of the Work Email and Associate ID fields and review these field values for employees in ADP before performing a sync, since these fields are key to integration's user creation and use user sync processes:

  • First Name
  • Last Name
  • Work Email - (This becomes the Litmos "username" for all ADP employees created in Litmos)
  • Title
  • Work Address
  • Work City
  • Work State
  • Work Zip
  • Work Country
  • Work Phone
  • Mobile Phone
  • Employment Status (This can be active, inactive or terminated in ADP. If an employee is terminated, that employee is still created in Litmos but is inactive and cannot login.)
  • Associate ID - (This becomes the Litmos "username" if no work email address exists on the employee record in ADP.)

Once an employee sync is done processing, a sync log will become available for review under the "Recent Imports" Panel within the "People" tab in Litmos. This sync log will be visible to the Litmos Account Owner who enabled the employee sync.


Have more questions? Submit a request


Please sign in to leave a comment.