Migrate your ADP Workforce Now data

Workers is ADP's core HR object representing persons who perform duties for an organization as employees or contractors. The Worker Management API exposes demographics, employment status, and work assignments. We map Workers to the destination system's Employee or Person object and preserve the Worker ID as a stable reference.

ADP supports 8 types of Worker Custom Fields (amount, code, date, indicator, number, percentage, string, telephone) applied at both the Worker and Worker Person levels. These are write-only via API — we can import custom fields but cannot export their current values without a read capability on the ADP API. We document which custom fields are in use during scoping.

The Deduction Instruction API supports voluntary deductions (health, retirement, benefits) but explicitly excludes Involuntary Withholding Orders (garnishments) and Company Loans, which are listed as future support. We map active voluntary deductions and flag garnishment records as requiring manual reconciliation post-migration.

ADP exposes APIs for Benefits: Beneficiaries, Benefit Dependents, and External Benefit Plans. We map benefit enrolments and coverage elections but note that plan configurations are employer-specific and may require re-creation or mapping of plan IDs to the destination system's equivalent structure.

The Time Off Requests API allows retrieval of time off history, current balances, and leave event records. We map accrued balances and leave histories but flag that leave plan configurations and accrual rules are ADP-administered settings that may not be fully accessible via API.

Payroll run history, pay stubs, and tax withholding records are accessible via the Payroll API. Historical pay data volumes can be large; we scope the date range during planning and map ADP payroll codes to destination earning and deduction codes using the customer's provided mapping tables.

ADP uses Locations and Departments as organizational units referenced throughout payroll and compliance. Validation Tables for Cost Numbers, Job Titles, and Locations are exposed via dedicated API endpoints. We preserve the full org hierarchy and map location-level compliance rules to the destination system's equivalent structure.

Validation Tables store domain values for Job Titles, Cost Numbers, Locations, and other reference data. We map these via the Validation Tables Cost Number API and similar endpoints, but note that the complete validation table set may vary by ADP edition and configuration. We pull the full set during discovery and map each to destination equivalents.

ADP exposes event notification webhooks for worker lifecycle events. During migration, we can configure ADP webhooks to capture new changes during the delta sync window. Note that some event types are edition-gated; we verify event coverage against the customer's ADP service agreement during scoping.

ADP Workforce Now's Talent Management module — covering performance reviews, goal setting, compensation planning, and learning — is not accessible via the public Workforce Now API. It uses a separate ADP proprietary interface. We do not migrate Talent Management data via API; this is flagged during scoping as a manual or separate-tool migration requirement.

Timecard and clock-in/out data is accessible via ADP's Workforce Management APIs. Third-party tools like Deputy and Lathem Time export timesheet data to ADP via CSV import. We map timecard records by employee and pay period, mapping ADP work order or job codes to destination earning codes.