iCIMS ADP Workforce Now Integration: A Consultant’s Guide
iCIMS Certified Consultants

iCIMS ADP Workforce Now Integration: A Consultant’s Guide

📅 March 26, 2026  |  ⏱ 10 min read  |  🏷 iCIMS Integration

Book a Free Integration Consultation

The iCIMS ADP Workforce Now integration is one of the highest-value connections you can make in your recruiting tech stack. When it works, new hire data flows from iCIMS straight into ADP the moment a candidate is marked hired. No manual re-entry. No payroll delays. No HR team chasing down an employee ID the day before orientation.

But getting there requires more than clicking a button in the marketplace. There are three distinct connector options, each with different timelines and real limitations. There are prerequisites in both systems that most teams miss. And there are at least five common problems that surface after go-live if the setup was rushed or ongoing maintenance was skipped.

We have configured this integration for multiple organizations as part of our iCIMS consulting services. This guide covers everything you need to know: which connector to choose, what to configure before you start, how the data flows in both directions, the full setup process, and what breaks most often after go-live.

🎯 What the iCIMS ADP Workforce Now Integration Actually Does

At its core, the iCIMS ADP Workforce Now integration is a bidirectional data connector. It creates a live channel between your ATS and your HCM so that the recruit-to-hire handoff happens automatically instead of through manual exports and re-entry.

ADP Workforce Now is the system of record. That matters for how you think about the integration. ADP owns the authoritative employee data. iCIMS is where you recruit. The connector bridges the two by doing three things:

  • Pushing new hire and rehire data outbound from iCIMS to ADP when a candidate clears your final hiring stage
  • Pulling foundational organizational data inbound from ADP to iCIMS so that department codes, job codes, pay groups, and locations stay synchronized
  • Updating existing employee records in iCIMS when rehires, transfers, or terminations occur in ADP

The result: your HR and payroll team in ADP sees a new hire record the moment recruiting closes the loop in iCIMS. And your recruiting team in iCIMS always sees accurate, ADP-sourced position and department codes to attach to requisitions.

💡 Worth Knowing
If your organization uses ADP Vantage HCM instead of ADP Workforce Now, there is a separate iCIMS connector available on the ADP Marketplace. The two connectors have different architectures and setup requirements. This guide covers ADP Workforce Now specifically.

📊 The Three Connector Options Compared

Before starting any configuration, you need to know which connector type fits your situation. iCIMS offers three approaches, and choosing the wrong one wastes time or leaves you with a system that cannot do what you need.

Connector TypeDeployment TimeConfiguration FlexibilityADP Onboarding SupportMonthly Cost
Quick Connect~2 weeksNon-configurable (standard fields only)❌ Not supported$500/mo
Configurable Bidirectional (without ADP Onboarding)10-12 weeksUp to 25 field changes or additions❌ Not included$500/mo
Configurable Bidirectional (with ADP Onboarding)10-12 weeksUp to 25 field changes or additions✅ Included$750/mo

Quick Connect is designed for teams that need a basic new hire data transfer with minimal setup friction. It does not require a long implementation project and can be live in about two weeks. The tradeoff is that it uses a standard field set with no customization, and it does not support ADP Workforce Now Onboarding. If your standard new hire fields match ADP defaults and you do not use ADP Onboarding, Quick Connect is worth considering.

Configurable Bidirectional is the right choice for most organizations. It gives you up to 25 custom field changes, supports ADP Onboarding data flows, and includes a dedicated iCIMS Professional Services resource who manages field mapping, testing, and go-live. The 10 to 12 week timeline sounds long, but most of it is structured testing and validation, not waiting around.

⚠️ Important Limitation
Population of custom fields in ADP Workforce Now via the ADP APIs is not currently supported in any connector version. If your ADP instance uses custom fields for payroll setup, onboarding, or compliance, you will need to plan for this before go-live. Most teams handle it with a manual data entry step for those specific fields, or a middleware tool if the volume is high.

Some older iCIMS customers are still running a flat file integration, which uses batch file exports from ADP processed into iCIMS on a schedule rather than a real-time API connection. If you are on a flat file setup, it is worth evaluating a migration to the bidirectional connector. The API-based connector is more reliable, surfaces errors faster, and removes the delay inherent in batch processing.

🔧 Prerequisites: What to Configure Before You Start

The most common source of post-go-live problems is not a technical failure. It is teams that start the connector setup before their data is clean. Here is what needs to be in place in both systems before configuration begins.

In iCIMS

The connector sends a new hire record to ADP when a candidate hits the final hired stage in your Recruiting Workflow. For that transfer to succeed, iCIMS requires several fields to be populated on the candidate profile and requisition. These fields have strict validation requirements and the transfer will fail silently if they are missing.

  • All required pre-hire fields are mapped in your Workflow Profile (department, job code, pay group, location, employment type)
  • Requisition fields that feed ADP are marked required and enforced at the appropriate workflow stage
  • Candidate profiles are being completed before the Hired stage with no blank required fields
  • Your iCIMS URL and ADP connection credentials are ready for the connector configuration
  • Admin access to the iCIMS integration console is confirmed

In ADP Workforce Now

The inbound lookup import service pulls organizational structure data from ADP into iCIMS every day. Those values need to exist and be accurate in ADP before the integration runs, or the dropdowns in iCIMS will be empty or incorrect.

  • Department structure and cost centers are finalized and accurate in ADP
  • Job codes and position codes are established and correctly assigned
  • Pay groups are defined and tied to the correct business units
  • Work locations are configured in ADP with accurate addresses
  • ADP admin credentials with integration permissions are available
  • If using ADP Onboarding, onboarding workflows are configured before go-live
✅ Consultant Tip
Do a data audit in both systems before kickoff. Pull a sample of 10 recent hires and check whether all required fields were populated correctly in iCIMS at the time of hire. If you find gaps, fix the Workflow Profile configuration before starting the integration project. Trying to fix data hygiene issues mid-implementation adds weeks to the timeline and a lot of frustration.

🔄 How the Bidirectional Data Flow Works

Understanding the direction and content of each data flow helps you configure the right fields and troubleshoot problems faster when something goes wrong.

Outbound: iCIMS to ADP

Legal first nameLegal last nameHome addressPersonal emailPersonal phoneDate of birthSSN / Tax IDEmployment typeJob titleDepartment codePay groupPay rateStart dateWork locationEEO data

31 total fields. Triggered when candidate reaches Hired status in iCIMS Recruiting Workflow.

Inbound: ADP to iCIMS

Employee IDLegal nameWork emailWork phoneWork locationDepartment codeJob titleManager nameTermination datePosition codesPay groupCost centerJob codeBusiness unitFLSA status

35 total fields. Inbound lookup runs on a daily schedule to populate iCIMS dropdown lists.

The inbound data serves two purposes. First, it populates the dropdown lists in iCIMS so recruiters can attach accurate department codes, job codes, and pay groups to requisitions. Second, it updates existing employee records in iCIMS when someone transfers, changes roles, or is terminated in ADP.

This is why clean ADP data is non-negotiable before go-live. If ADP has duplicate department codes, legacy position codes that are no longer active, or pay groups renamed without being updated, those problems will propagate into iCIMS through the inbound sync. Garbage in, garbage out applies here as much as anywhere else in HR technology.

⚙️ Step-by-Step Setup Process

The full Configurable Bidirectional Connector is implemented as a structured project with an iCIMS Professional Services resource. Here is how the process typically unfolds.

  • 1
    Purchase and connector selectionChoose your connector version through the ADP Marketplace or via your iCIMS account manager. You will need to provide your iCIMS URL during purchase. For the configurable version, iCIMS Professional Services will contact you within 5 to 8 business days to schedule a kickoff.
  • 2
    Kickoff and requirements gatheringYour iCIMS PS resource will run a discovery session to document your field mapping requirements. They will want to understand which ADP fields need to match which iCIMS fields, which hire statuses trigger the outbound transfer, and whether you are using ADP Onboarding.
  • 3
    Data preparation in both systemsBefore configuration begins, complete the prerequisites listed above. This is the step most teams underestimate. It is tempting to start the integration project before the ADP structure is finalized, but doing so forces rework during testing and extends the timeline.
  • 4
    Field mapping configurationYour PS resource configures the outbound field map (iCIMS fields to ADP fields) and the inbound lookup schedule (ADP organizational codes to iCIMS dropdowns). For the configurable version, you have up to 25 field-level customizations. Document every mapping decision in a spreadsheet. You will need it later.
  • 5
    Sandbox testingRun test hires through the workflow end-to-end. Create a candidate, move them through the Recruiting Workflow to the Hired stage, and verify that the pre-hire record appears correctly in ADP Workforce Now. Also run a manual inbound sync and confirm that department codes, job codes, and pay groups populate correctly in iCIMS dropdowns.
  • 6
    Stakeholder validationHave someone from payroll or HRIS review the ADP records created during testing. Have a recruiter confirm that the iCIMS-side dropdowns are correct. This cross-functional validation step catches issues the technical team might miss.
  • 7
    Go-live and monitoring setupActivate the integration for production. Review the iCIMS integration error logs at least weekly for the first 30 days. Assign clear ownership of the integration to a specific person on your team so there is always a point of contact when something breaks.
💡 On Transition Timing
If you have an existing flat file integration running between iCIMS and ADP, do not cancel it until iCIMS Professional Services explicitly confirms that the new connector is fully deployed and stable. Running the old and new integrations in parallel for a short period prevents any data gap during the transition.

If you need help managing this process or want a consultant to own the requirements documentation and stakeholder coordination, our iCIMS implementation consultant services are built for exactly this kind of integration project. We have run this setup many times and know exactly where teams get stuck.

Not Sure Which Connector Fits Your Setup?

We can review your iCIMS and ADP configuration and give you a direct recommendation in a single session.

Book a Free Consultation

🔥 5 Common iCIMS ADP Workforce Now Integration Problems (and How to Fix Each One)

Even well-executed integrations run into problems after go-live. Here are the five we see most often, along with what actually causes them and how to fix them.

Problem 01

Department codes and position codes are missing in iCIMS requisitions

What causes it: The inbound lookup import service from ADP to iCIMS is not running, is not scheduled, or was configured to pull a subset of codes that does not match what your recruiters need.

How to fix it: Check the integration schedule in your iCIMS admin console. Confirm that the lookup import for departments, job codes, pay groups, and locations is set to run daily. Run a manual sync and verify the values appear in the relevant iCIMS dropdown fields. If codes are still missing after the sync, confirm they exist and are active in ADP Workforce Now itself.

Problem 02

Required pre-hire fields block the outbound transfer to ADP

What causes it: iCIMS requires specific fields to be populated before sending a new hire record to ADP. If a recruiter moved a candidate to Hired without completing all required fields, the transfer fails silently or throws an error that only appears in the integration log.

How to fix it: Update your iCIMS Workflow Profile to enforce required field completion before the Hired status is reachable. Add a validation gate at the offer stage so that fields like department code, pay group, start date, and work location are filled before the candidate can advance. Review the integration error log for specific fields that failed and remediate any stuck records manually.

Problem 03

Custom ADP fields are not receiving data from iCIMS

What causes it: This is a known platform limitation, not a configuration error. The ADP APIs used by the connector do not support population of custom fields in ADP Workforce Now. If your ADP instance uses custom fields for compliance, payroll setup, or onboarding, those fields will remain empty after the integration transfer regardless of how you configure the connector.

How to fix it: Map out which custom fields need to be populated and decide how they will be handled. Options include a manual data entry step in ADP after the new hire record is created, a middleware integration layer such as The Cloud Connectors via the iCIMS Marketplace, or advocating internally to convert those fields to standard fields if the data is core to your process.

Problem 04

Integration breaks silently after ADP organizational structure changes

What causes it: A department is added, a pay group is renamed, or a location code is updated in ADP Workforce Now without notifying whoever manages the iCIMS integration. The connector tries to match against values that no longer exist and either fails or transfers incorrect data without triggering an obvious alert.

How to fix it: Establish a change management process that requires any ADP organizational structure change to be communicated to the iCIMS integration owner before implementation in ADP. Add a recurring monthly task to audit the iCIMS integration logs for errors and compare active ADP code lists against values appearing in iCIMS requisitions. If no one internally owns this, our iCIMS managed services cover exactly this kind of ongoing integration governance.

Problem 05

Quick Connect does not support your ADP Onboarding workflow

What causes it: Teams that chose Quick Connect for its fast deployment discover later that it does not include ADP Workforce Now Onboarding data flows. If your ADP Onboarding process depends on pre-hire data from iCIMS, the Quick Connect version cannot deliver it regardless of any workaround.

How to fix it: Upgrade to the Configurable Bidirectional Connector with ADP Onboarding support. This requires the full 10 to 12 week implementation project and there is no shortcut within the Quick Connect tier. Plan for this before purchase if ADP Onboarding is part of your workflow. It is one of the first questions we ask during a discovery call before recommending a connector version.

For related troubleshooting patterns, our guide to iCIMS workflow rules not triggering covers configuration gaps that often overlap with integration issues. And if you are running background check vendor connections alongside ADP, the iCIMS background check integration setup guide walks through a similar diagnostic pattern for that connector type.

📋 Ongoing Maintenance Checklist

The integration does not maintain itself. This is probably the single most important thing we tell clients after go-live. Your ATS and HCM are both living systems. Every new hire, every org chart change, every new ADP module creates potential ripple effects in the connector.

  • Weekly: Review the iCIMS integration error log for failed transfers or sync errors
  • Weekly: Confirm that inbound lookup syncs (departments, job codes, pay groups, locations) are running successfully
  • Monthly: Spot-check 3 to 5 new hire records in ADP against corresponding iCIMS candidate profiles to verify field accuracy
  • Before any ADP org change: Notify the iCIMS integration owner so field mappings can be updated proactively
  • Quarterly: Full governance review, audit field mappings, compare active ADP codes against iCIMS dropdown values, check connector version for available updates
  • Annually: Evaluate whether the connector version still fits your needs as your ADP configuration evolves

If your team does not have the internal bandwidth to handle this consistently, a managed services arrangement that includes iCIMS integration governance is worth considering. The cost of a missed integration error that delays a new hire’s payroll setup almost always exceeds the cost of proactive management.

For a broader look at how the ADP integration fits into your full iCIMS configuration, the iCIMS implementation guide covers the pre-kickoff planning work that makes every downstream integration run more smoothly. And if you are managing a Workday environment alongside ADP for different business units, our iCIMS Workday integration setup guide covers the parallel process for that connector.

❓ Frequently Asked Questions

How long does the iCIMS ADP Workforce Now integration take to set up?

The Quick Connect option deploys in approximately 2 weeks. The full Configurable Bidirectional Connector requires 10 to 12 weeks for implementation, including field mapping, testing, and go-live. Most of that time is structured testing and validation, not waiting on iCIMS.

Does the iCIMS ADP integration support custom fields in ADP Workforce Now?

No. As of the current connector version, population of custom fields in ADP Workforce Now via the ADP APIs is not supported. If your ADP instance relies on custom fields for payroll or onboarding, you will need a workaround such as a manual data entry step or a middleware tool for those specific fields.

What triggers the data transfer from iCIMS to ADP Workforce Now?

The outbound transfer is triggered when a candidate reaches the Hired status in your iCIMS Recruiting Workflow. The integration then sends the pre-hire record to ADP as a new hire or rehire. All required pre-hire fields must be populated before this transfer will succeed.

What is the difference between Quick Connect and the Configurable Bidirectional Connector?

Quick Connect is non-configurable and deploys in about 2 weeks with a standard field set. The Configurable Bidirectional Connector supports up to 25 field customizations, ADP Onboarding data flows, and a full iCIMS Professional Services implementation project. Quick Connect does not support ADP Workforce Now Onboarding.

Why are department codes and position codes missing in iCIMS after setup?

This usually means the inbound lookup import service from ADP to iCIMS is not running or not configured. The integration needs to pull foundational data from ADP into iCIMS on a daily basis so that requisition dropdowns populate correctly. Check your integration schedule and verify the lookup import service is active and running without errors.

How do we maintain the integration after go-live?

Ongoing maintenance requires reviewing the iCIMS integration error logs weekly, updating field mappings when ADP organizational structures change, and running a quarterly governance review. Any changes to ADP departments, cost centers, pay groups, or location codes need to be communicated to the iCIMS integration owner before going live in ADP.

Is this integration compatible with ADP Vantage HCM?

No. The iCIMS Connector for ADP Workforce Now is specific to ADP Workforce Now. If your organization uses ADP Vantage HCM, there is a separate iCIMS Connector for ADP Vantage HCM available on the ADP Marketplace. The two connectors have different architectures and setup requirements.

Need Help Setting Up or Fixing Your iCIMS ADP Integration?

We have done this many times. Tell us what you are dealing with and we will give you a straight answer on what to do next.

Book a Free Consultation

Similar Posts