# ADP iHCM — HRIS API: overview

> Canonical URL: https://developers.apideck.com/apis/hris/adp-ihcm/overview

ADP iHCM (Integrated Human Capital Management) is a comprehensive HCM solution designed for small to medium-sized businesses. It offers a range of services that include payroll, HR, time and attendance, talent management, and benefits administration.
- Status: live
- Authentication: oauth2

- **partnership note:** The ADP Marketplace Partner Program is a separate route that adds a sandbox and partner API access under a partner agreement; API Central needs no partnership.
- **difficulty:** highly_complex
- **partnership required:** false
- **difficulty reason:** Custom Auth + Multi-Step Per-Consumer Setup
- **sandbox available:** false
- **consumer access level:** An ADP administrator who can enable API Central for the account and obtain the certificate and credentials.
- **authentication note:** Client credentials over mutual TLS on ADP's EU infrastructure, not a user-consent flow. Needs an X.509 client certificate, Client ID and Secret.
- **responsibility matrix:**   - **customer:** Share requirements
  - **area:** Enable ADP API Central on the iHCM account
  - **consumer:** ✓
  - **consumer:** ✓
  - **area:** Obtain the certificate and credentials from ADP
  - **consumer:** ✓
  - **customer:** Implement Vault
  - **area:** Enter credentials in Vault
  - **area:** Authorize connection
  - **apideck:** Mints the OAuth token over mutual TLS
  - **consumer:** ✓
  - **customer:** Prompt the consumer
  - **area:** Replace the certificate before it lapses
  - **consumer:** ✓
  - **customer:** ✓
  - **apideck:** Maintains the connector
  - **area:** Build via the Unified API
  - **area:** Connection sync
  - **apideck:** ✓ Polls via virtual webhooks
  - **consumer:** Can revoke credentials or the certificate
  - **area:** Monitor connections
  - **customer:** ✓ Via the Apideck Dashboard
  - **apideck:** Logs and alerts
- **costs:** Paid by the consumer: ADP bills API Central International as a recurring subscription; prices are shown after signing in. No free trial.
- **apideck credentials available:** false
- **sandbox note:** A test instance exists only inside ADP's Marketplace Partner enrollment, which this connection model does not use.
- **account type required:** An ADP iHCM account, ADP's HR and payroll platform outside the US and Canada, with ADP API Central enabled.
- **environment notes:**   - **environment:** Single environment
  - **description:** ADP iHCM uses one set of consumer-provisioned credentials: Client ID, Client Secret, client certificate and client key. There is no separate sandbox with its own credentials. To test, use an ADP iHCM account that has API Central enabled. Apideck cannot supply temporary shared test credentials for this connector, because it has no Apideck-hosted sandbox app. Take care when testing against live payroll and HR data.
- **rate limits:** 120 requests/minute per API Central project and a maximum of 10 concurrent requests; ADP returns HTTP 429 beyond either limit.
- **webhooks:** Virtual webhooks - Apideck polls for employee created and updated events
- **apideck credentials note:** Each consumer provisions their own ADP credentials and certificate.
- **important to know:** An iHCM subscription alone never yields credentials: the consumer must have ADP API Central enabled first. Plan for that decision landing inside your onboarding flow rather than before it.
Consumers in the US or Canada are not on iHCM: ADP sells Workforce Now there, which Apideck supports through a separate connector. Confirm which ADP platform a consumer runs before pointing them at this one.
The connection depends on a client certificate and stops working the moment it lapses: a dated, per-connection failure that lands long after the build is finished.
You cannot de-risk this build before a consumer commits: your first end-to-end test necessarily runs against that consumer's live iHCM tenant.
- **supported resource categories:**   - **name:** People
  - **resources:** employees
  - **resources:** companies
departments
  - **name:** Organisation
  - **resources:** employee-schedules
time-off-requests
  - **name:** Time

## Supported resources

- **status:** live
- **id:** employees
- **downstream name:** Workers
- **custom field support:** true
- **downstream id:** workers
- **name:** Employees
- **downstream name:** Companies
- **id:** companies
- **name:** Companies
- **downstream id:** companies
- **custom field support:** false
- **status:** live
- **custom field support:** false
- **downstream id:** departments
- **name:** Departments
- **status:** live
- **downstream name:** Departments
- **id:** departments
- **downstream name:** Work Schedules
- **name:** Employee Schedules
- **custom field support:** false
- **status:** development
- **id:** employee-schedules
- **downstream id:** work-schedules
- **status:** live
- **downstream id:** time-off-requests
- **custom field support:** false
- **name:** Time Off Requests
- **downstream name:** Time Off Requests
- **id:** time-off-requests

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/hris/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/hris/coverage)