Introduction
Sapling can sync new hire data with your ADP account, saving your HR, People Operations, and Payroll manual data entry and removing the risk of errors, while providing a great new hire experience.
ADP Workforce Now is ADP's payroll solution for mid-size businesses. Sapling’s integration with ADP allows you to:
Collect all the information you need for all employee records
Automate workflows, setup triggered notifications, and reminders across multiple departments, locations, and stakeholders, with detailed analytics around workflows
Push new employee information to ADP Workforce through a Hire/ Rehire Template
Ensure key employee information stays synchronized with a seamless two-way integration updated daily at 12:00 am PST
The integration is available in the ADP Marketplace and you can request the Sapling integration in the ADP Marketplace.
How It Works
Sapling leverages ADP’s Workers v2 API, which allows Sapling to send applicants (and key information collected by Sapling) into ADP’s New Hire Wizard within ADP Workforce Now. This then allows an ADP admin to login, confirm and enrich the applicant's data, then complete the new hire in the ADP onboarding wizard itself.
Following the sync from Sapling to ADP, an Associate ID is created in ADP. Each employee’s ADP Associate ID is automatically fetched by Sapling and attached to the employee’s Sapling Profile. Sapling then uses this Associate ID to match any changes from ADP back into Sapling, ensuring key information stays in sync for all your employees.
Setting up the Integration
Data Flow Overview
Overview
In order to provision the new record in ADP Workforce, the following information is required in Sapling:
Name (typically pushed into Sapling from your company’s ATS)
Personal Email (required input)
Start Date (typically from your ATS)
SSN (collected from new hire)
Gender (collected from new hire)
Birthday (collected from new hire)
Address (collected from the new hire)
Integration Fields
Sapling is continually expanding the number of fields that sync between Sapling and ADP based on those that become available on ADP’s APIs.
Here is a full list of Sapling and ADP Integration Fields
Sapling will sync daily with ADP
Any changes that are made in ADP to the available fields will sync over from ADP and be reflected in Sapling. Changes are synchronized daily at 12:00 am PST
Key Factors to be aware of
ADP Stated Limitations
Like all software, there are some known limitations of the ADP Workforce API. The key ones for Sapling customers to be aware of are:
US879795: Custom Templates (Except the Applicant Onboard Template) are not Supported
US1238045: Issue with Posting Details of an Employee Who has been Previously Terminated
US905487: Fields not Supported through API
Documents: Uploaded documents are managed by ADP's internal doc cloud service and are not fully embedded in the Workforce Now product. Today, only internal APIs exist for the doc cloud, and adding external API support is not on ADP's current product roadmap.
Multiple Onboarding Templates Management
Enable US-based onboarding templates to toggle: This toggle will provide the list of US-based templates, and users will be created using ADP onboarding API-V1.
Multiple onboarding templates toggle: This toggle will provide the list of all the templates (US-based and International), and the user will be created using ADP onboarding API-V2.
When the Multiple onboarding templates (US-based and International) toggle is enabled, Sapling will create the Worked in Country as a Multiple Choice field and populate all the options automatically.
For Multiple onboarding templates (US-based and International), Worked in Country and ADP Company Codes (You have to enable ADP Company Codes toggle as well) as these are required fields.
ADP onboarding API-V2 has strong validation and ADP onboarding API-V1 has a lower validation.
You can only enable one toggle (Enable US-based onboarding templates OR Multiple onboarding templates) at a time. When enabling one option, the other option will be disabled automatically.
Rehiring in Sapling and ADP
Rehire must first be made in ADP
The changes will then sync back to Sapling (daily at 12:00 am PST) provided the 2-way sync is enabled
When these changes occur, updated rehired team members will appear in the Transitions dashboard in Sapling
From the Transitions Dashboard, you can click into the user profile and assign the appropriate workflow and documents
Managing Locations, Teams, and Business Units
Often partners are managing multiple field categories in their ATS and seek to understand how Teams, Locations, and Commitments map to ADP. Sapling commonly sees:
Employment Status = Worker Category
Team = Home Department
Location = Location
For these to sync correctly, the naming conventions must match between Sapling and ADP.
Job Titles in Sapling & ADP
To ensure a consistent data flow between Sapling and ADP, Job Titles are pulled from ADP into Sapling.
This syncing of data is used to ensure that Program Leads assign the appropriate Job Title to new hires. To achieve data accuracy of Job Titles, the Job Title must be listed in ADP for it to be reflected in Sapling.
Multiple Company Codes
Enable multiple company codes must be toggled on in order to create the ADP Company Code field and map correctly from Sapling to ADP.
Send multiple company codes provided the company codes are available on the list returned by code list API "/codelists/hr/v3/worker-management/company-code-values".
When onboarding an employee, the company code can be selected and the ADP company code will be selected based on the values inputted.
Be notified about changes in company codes, and update the company code in Sapling.
Sapling cannot send changes in company codes (i.e. for transfers) to ADP and these must be managed manually.
Multiple Applicant Onboard Templates
ADP WFN offers templates for practitioners to start the new hire process. The Applicant Onboard API supports the following templates:
HR + Payroll (System)
HR + Payroll + Time (System)
HR + Time (System)
HR Only (System)
In addition, the Applicant Onboard API supports one custom template as long as the name is Applicant Onboard.
Custom Fields
ADP supports custom fields with two current constraints. They must be:
Text field type (not numbers, multi-choice, etc.)
Set up in the Employment Custom Fields section (not profile or other sections)
This requires custom development work from the Sapling Solutions team and is subject to additional charges.
Manager (Reports To)
The Manager field in Sapling and the Reports To field in ADP will be synced.
To see changes from Sapling to ADP reflected for this field, the person being assigned as the Manager must have the Management Position field set to "Yes" in their ADP Position record.
You can set this value in ADP before or after making the Manager change in Sapling.
Ask Us About
Time Off with Sapling and ADP
Benefits with Sapling and ADP
Offboarding with Sapling and ADP
Syncing Sapling with International ADP Profile templates
Speak to your Sapling Customer Success Manager to learn more about the above.
💡Looking to do more? Check out our API or Check out our Customer Success Stories.