Connect ADP iHCM to Microsoft Entra ID

Connect ADP iHCM to Microsoft Entra ID

Connect ADP iHCM to Microsoft Entra ID

When someone joins, moves or leaves in ADP iHCM, you want that change reflected in Microsoft Entra ID without anyone touching it by hand. To connect ADP iHCM to Microsoft Entra ID, Joinly reads each HR change at the source — through the ADP Worker Management API in API Central — and applies it automatically to the right account. iHCM stays your source of truth; Joinly is the engine that keeps every action accurate and traceable, even across the multiple European countries a single iHCM tenant covers.

Key takeaways

  • ADP iHCM stays your source of truth; Joinly applies every joiner, mover and leaver to Entra ID automatically.

  • Joinly maps iHCM organisation data — department, cost center and job title, across the several country org charts a single iHCM 2 tenant holds — to the right Entra ID groups and licences, which the SSO-only ADP gallery app cannot do at all.

  • Because iHCM 2 runs a single European cloud spanning countries like Germany, Italy, the Netherlands and the UK, Joinly applies country-aware UPN, group and licence rules so one tenant provisions correctly per country.

  • A worker with more than one work assignment keeps a single account driven by the primary assignment, instead of being provisioned twice.

  • Every action is logged for a complete audit trail, aligned with NIS2 and ISO 27001.

ADP iHCM

Joiner

Mover

Leaver

Microsoft Entra ID (formerly Azure AD)

Quick facts

Source system

ADP iHCM (iHCM 2)

Target system

Microsoft Entra ID (formerly Azure AD)

Connection method

ADP Worker Management API (API Central) → Entra ID

Supported events

Joiner, mover, leaver (incl. rehire, transfer, multiple work assignments, cross-country moves)

Synced attributes

Name, email / UPN, department, cost center, job title, manager, associate ID (associateOID), country, hire and termination date

Authentication

OAuth 2.0 (client_credentials) over mutual TLS with an X.509 client certificate

Real-time or batch

Frequent sync, multiple times per day

Compliance

ISO 27001, NIS2-ready, GDPR (EU data centre)

How does Joinly sync ADP iHCM to Microsoft Entra ID?

Joinly reads each HR change in iHCM through the ADP Worker Management and Organization Management APIs and applies it to the matching Entra ID account automatically. iHCM holds the authoritative worker record, so it is the starting point for each identity action.

  1. Joiner. HR completes the hire in iHCM. Joinly reads the new worker — the associateOID and the primary work assignment — and determines the role from attributes like department, cost center, job title and country. It then creates the account in Entra ID, assigns the right licences and maps the person into the correct groups — timed to the effective hire date.

  2. Mover. When a worker changes work assignment, department or cost center in iHCM — including a move between country org charts — Joinly updates their group membership, permissions and licences to match. Access that no longer fits the new assignment is revoked, so permissions stay aligned with the actual job.

  3. Leaver. On the termination date recorded in iHCM, Joinly disables the Entra ID account automatically. There are no orphaned accounts left active after someone has left, and where a worker holds more than one work assignment, access is only removed when the last active assignment ends.

Example: A European manufacturer runs iHCM 2 across its German, Italian and Dutch entities on one tenant. It hires a process engineer with a hire date next Monday in the German org chart. Joinly reads the worker record, waits until the hire date, creates the Entra ID account, assigns an Office E3 licence and adds the engineer to the DE-Engineering group with a de-suffixed UPN. When that engineer later takes on a second work assignment in the Italian plant, Joinly keeps the primary assignment as the driver of the UPN and adds the IT-Operations group without creating a duplicate account.

What manual user management costs

Without automation, every account starts as an ADP report or a line in a spreadsheet that IT works through by hand. The Entra gallery ‘ADP’ app only delivers single sign-on, not provisioning, so unless you buy a separate sync bridge there is no native path from iHCM to Entra ID — and even then role-to-group mapping, hire-date timing and multi-country, multi-assignment handling fall to people.

  • Onboarding delays. New joiners wait for accounts, licences and group access while a ticket sits in a queue, losing productive days in their first week.

  • Permissions that don’t keep up (privilege creep). When workers change assignment, department or country, old access often stays attached, so people accumulate rights they no longer need.

  • Forgotten offboarding. Accounts that aren’t disabled on time are both a security and audit risk, and unused licences keep costing money — and with multiple work assignments it is easy to disable an account while another assignment is still active.

Joinly vs. the native ADP provisioning options

The Entra gallery ‘ADP’ app covers single sign-on only; for actual provisioning ADP points you at third-party Marketplace connectors and sync bridges. Here’s how that baseline compares to Joinly for an iHCM-driven setup.


Joinly

Entra gallery app / ADP sync bridge

Source

Reads the ADP Worker Management API directly

Gallery app does SSO only; bridge reads ADP separately

Role-to-group mapping

Built in, rule-based on department and cost center

No role-to-group out of the box; manual or bridge config

Multi-country tenant

Country-aware UPN, group and licence rules per org chart

One flat mapping; per-country logic is manual

Hire-date / future hires

Times account creation to the effective hire date

Not handled by the gallery app; bridge needs custom logic

Multiple work assignments

Resolves primary vs additional assignment for the UPN

Assignment confusion can create duplicate accounts

Licence assignment

Driven by role / attributes

Manual or group-based only

On-premise AD

Yes, own agent plus the native Microsoft agent

Requires a separate sync bridge, limited mapping

Audit trail

Per-action logging tied to the HR source

Limited

Watch-outs when connecting ADP iHCM to Microsoft Entra ID

A few iHCM-specific details decide whether this connection stays reliable at scale.

  • One European cloud, several country structures. iHCM 2 runs a single European cloud spanning countries such as Germany, Italy, the Netherlands and the UK, so one tenant can carry several org charts, department codes and naming conventions. Joinly applies country-aware rules — the UPN suffix, group prefix and licence bundle follow the worker’s country and org chart — so a Dutch and a German hire land in the right place from the same feed.

  • Multiple work assignments. A worker can hold more than one active work assignment. A naive rule treats every assignment as a new person and provisions duplicate Entra ID accounts. Joinly keys on the associateOID and picks the primary work assignment as the driver of the UPN, while still reflecting the extra access.

  • Mapping department and cost center to Entra groups. iHCM’s departments (each with its own itemID payroll code) and cost centers don’t translate one-to-one to Entra ID groups. Joinly builds explicit mapping rules from those structures to the correct groups and licences, so role drives access rather than manual assignment.

  • Certificate-based API onboarding. The link to ADP runs over mutual TLS with an X.509 certificate issued from the ADP partner self-service portal, and that certificate expires. Joinly manages the mTLS connection and flags certificate rotation in advance, so the feed from iHCM never silently goes dark.

  • SSO is not provisioning. The Entra gallery ‘ADP’ app only handles sign-on; it never creates, updates or disables an account. Joinly is the provisioning layer that the gallery app deliberately leaves out, reading worker changes and acting on them in Entra ID.

Joinly handles each of these by default with custom mapping and transformation.

Always audit-ready

Every account action Joinly performs is logged: who was affected, when it happened, which access changed and which iHCM change triggered it. For NIS2 that matters directly: access can be traced back to an authorised HR source rather than an ad-hoc request. Joinly is ISO 27001 certified, runs in an EU data centre in Amsterdam, applies least-privilege by default, and is built to meet NIS2 and ISO 27001.

Example case

Picture a European manufacturer with around 5,500 employees, running iHCM 2 on a single tenant that spans its German, Italian and Dutch plants while its identity provisioning never quite keeps up. The Entra gallery ‘ADP’ app gives people single sign-on but provisions nothing, so a spreadsheet exported per country still drives every account by hand — Dutch and German hires get inconsistent usernames, workers who pick up a second work assignment at another plant end up with a duplicate Entra ID account, and future hires are provisioned the moment HR saves the record rather than on their actual start date.

Connect ADP iHCM to Microsoft Entra ID with Joinly and that work disappears. Joinly reads each HR change in iHCM at the source and acts on it automatically: new hires have their account, Office licence and country-correct group access ready on their effective hire date, moves between plants and country org charts swap the right groups the same day, a second work assignment just adds access on a single stable UPN, and leavers are disabled on their termination date with a 30-day soft-delete grace window.

“One iHCM tenant, three countries, and provisioning used to mean three different spreadsheets and the odd duplicate account. Now an account is simply ready on the hire date with the right country naming, a second assignment just adds access, and we can show the auditor exactly which iHCM change created every bit of access.” — Head of IT, European manufacturer

The outcome this setup is designed for: onboarding drops from days to zero touch, cross-country naming and duplicate-account errors stop entirely, and the team can walk into its next NIS2 assessment with a complete, source-backed audit trail.

More than a connector

A standalone iHCM to Entra ID connection is a good start, but identity rarely stops at one target. Joinly manages the complete chain from joiner to leaver across all your systems, with logging and governance built in. You review the exceptions; Joinly maintains the chain.

Schedule a demo

Installation manual

Installation manual

Connect ADP iHCM to Microsoft Entra ID

Connect ADP iHCM to Microsoft Entra ID

Installation guide

Follow these steps to connect ADP iHCM to Microsoft Entra ID with Joinly. The entire cloud setup happens in the platform, with no scripts or local software required.

1. Create your account

Go to platform.joinly.app and create your account.

Note: charges may apply for using the platform after the trial period ends.


Joinly account creation screen at platform.joinly.app


Sign up at platform.joinly.app to get started.

2. Connect your Microsoft account

Open platform.joinly.app/settings/provisioning/idp-setup and connect your Microsoft tenant. Select the scopes you need. For provisioning you don’t need any additional scopes.


Joinly identity provider setup screen for connecting a Microsoft Entra tenant


Connect your Microsoft tenant and pick your scopes.

3. Import your existing accounts from Entra ID

Import all existing accounts from Entra ID at platform.joinly.app/settings/provisioning/entra-import. This gives Joinly a baseline of every account that already exists, so it can match people to their current account instead of creating duplicates.

4. Find the ADP iHCM integration in the Joinly marketplace

Open the Joinly marketplace and search for the ADP iHCM integration.

Don’t see your system listed? Get in touch at support@koppelhet.nl and we’ll help you out.


Joinly marketplace showing available HR integrations


Search the marketplace for the ADP iHCM integration.

5. Follow the installation wizard

You may be redirected to integrations.joinly.app. Create an account there and enter your iHCM connection details: your ADP API Central client ID and secret, plus the X.509 client certificate and private key you generated in the ADP partner self-service portal for the mutual-TLS connection. We only ask for the information needed to establish a successful connection with ADP. All data is encrypted and stored securely.


Joinly installation wizard for entering ADP iHCM connection details


Enter your ADP API Central credentials and client certificate in the wizard.

6. Configure your field mapping

Set up all your field mappings here. Templates support Liquid, so you can build your display name, UPN and other attributes dynamically from iHCM fields — including country-aware rules for a multi-country tenant.

Frequently asked questions

  • How do I map the manager? Reference the manager’s associateOID (the reportsTo link) in the mapping and Joinly resolves it to the right manager automatically.

  • How do I handle multiple work assignments? Pick the primary work assignment as the driver for the UPN; Joinly exposes all of a worker’s assignments so you can choose the primary one.

  • How do I keep usernames correct per country? Branch on the worker’s country or org chart in your Liquid template to apply the right UPN suffix and naming convention.

  • How do I prevent duplicate usernames? Use the generateUniqueUsername helper, which falls back to the next pattern when the first one is already taken:
    {{ generateUniqueUsername: “{firstName}.{prefix}.{lastName}”, “{initials}.{prefix}.{lastName}” }}


Joinly field mapping screen for ADP iHCM attributes using Liquid templates


Map iHCM fields to Entra ID attributes with Liquid templates.

7. Configure the scheduled import

At platform.joinly.app/settings/import-configs, configure how often the import from iHCM should run.

8. Configure your workflows

Workflows are where Joinly turns each HR change into the right action in Entra ID. Create an onboarding (joiner) and offboarding (leaver) workflow with trigger-based execution, then an Identity updated workflow with a Create/update employee in Entra action so every change in iHCM flows straight through to Entra ID. Finally, add a threshold workflow with the Entra soft delete action that runs a set period after the termination date (for example 30 days) to retire accounts safely.


Joinly workflow editor creating an employee onboarding workflow


Create a trigger-based onboarding workflow.


Adding the create or update employee in Entra action to a workflow


Add the create/update action, then set your matching strategy and field mapping.


Adding the Entra soft delete action to remove accounts on employee leave


Add the Entra soft delete action to retire accounts safely.

## AD on-premise support

Need to provision to an on-premise Active Directory as well? See our dedicated guide on connecting ADP iHCM to Active Directory, or contact support at support@koppelhet.nl to request setup of the Joinly AD Agent.

Frequently asked questions

Does the ADP iHCM to Microsoft Entra ID connection work in real time?
It runs as a frequent sync that updates multiple times per day, so changes in iHCM reach Entra ID quickly without waiting for a nightly batch.

Doesn’t the Entra gallery ‘ADP’ app already do this?
No. The gallery app provides single sign-on (SAML/OIDC) only — it never creates, updates or disables accounts. Joinly is the provisioning layer that reads worker changes from the ADP API and applies them to Entra ID.

How does Joinly handle an iHCM tenant that spans several countries?
iHCM 2 runs a single European cloud, so one tenant can hold several country org charts. Joinly branches on the worker’s country or org chart to apply the right UPN, group and licence rules, so each country provisions correctly from the same feed.

How does Joinly handle workers with multiple work assignments?
Joinly keys on the associateOID and reads every work assignment a person holds, then applies your rules to pick the primary assignment as the driver for the UPN, so a second assignment adds access without creating a duplicate account.

Which attributes sync from ADP iHCM to Entra ID?
Name, email / UPN, department, cost center, job title, manager, associate ID (associateOID), country, and hire and termination date. Custom iHCM fields can be mapped via Liquid templates.

Does Joinly also support AD on-premise or hybrid provisioning?
Yes. Joinly has its own AD on-premise agent and also supports the native Microsoft Entra provisioning agent, so you can provision users to your on-premise AD environment as well. See the iHCM to Active Directory guide.

Request installation support