> For the complete documentation index, see [llms.txt](https://docs.siit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siit.io/integrations/hris/adp.md).

# ADP

<figure><img src="/files/LfFiZCjgWoTcat0ijTOG" alt=""><figcaption></figcaption></figure>

### What you get

* **Live People directory** — ADP workers appear in Siit with their role, manager, department, and location.
* **Lifecycle triggers** — Hire date, Rehire date, Termination date, Work anniversary, and Birthday flow into Siit as workflow triggers.
* **Department and location hierarchies** — preserved for routing, audiences, and reporting.
* **Manager resolution** — ADP reporting structure powers auto‑selected approvals.
* **Multi‑company support** — for customers with multiple ADP companies, each one's workers are synced with their company / legal entity attached.

### What syncs from ADP

| Category        | Fields                                                                      |
| --------------- | --------------------------------------------------------------------------- |
| Identity        | Preferred name, legal name, work email, Associate ID (AOID), Worker ID      |
| Role            | Job title, job code, job function, pay grade                                |
| Org structure   | Manager, department, location, company / legal entity, cost center          |
| Employment      | Worker category (Employee / Contractor), status (active, leave, terminated) |
| Lifecycle dates | Hire date, rehire date, termination date, date of birth                     |
| Custom          | Selected custom fields from ADP                                             |

Work email is the canonical identifier. Make sure it's populated in ADP before connecting.

### Before you connect

* You'll need **ADP admin access** with authority to install marketplace apps.
* Siit must be added to your ADP organization via the **ADP Marketplace**. Your ADP rep can help if the install is restricted.
* Agree with your ADP admin on which worker categories and companies should be synced.

### Connect ADP

#### Part 1 — In the ADP Marketplace

1. Sign in to the [**ADP Marketplace**](https://apps.adp.com/) as an admin.
2. Search for **Siit** and click **Buy Now** (it's free to install).
3. Review the data scopes requested and approve the subscription.
4. Once installed, the Siit app appears in **My Apps** with a Consent button.
5. Click **Grant Consent** — you'll be redirected to Siit to finalize the connection.

#### Part 2 — In Siit

1. Siit automatically picks up the subscription created in ADP and opens the HRIS setup flow.
2. Review the imported workers (initial import can take a few minutes for large orgs).
3. Configure field mapping, including any custom fields you want to sync.
4. Click **Finish setup**.

> **Tip** — If you don't see Siit in the ADP Marketplace, it may be restricted by your ADP organization's marketplace policy. Ask your ADP rep to enable marketplace self‑service.

### After the connection

* **Verify counts** — compare Siit's People total with "Active Workers" in ADP Workforce Now.
* **Set source of truth** — in **Settings → People → Fields**, pick ADP for payroll / employment fields (legal name, company, cost center).
* **Custom fields** — if you use custom worker fields in ADP, add them in Siit's ADP settings after connection.
* **Build workflows** — lifecycle workflows are usually the first thing customers build on top of an ADP sync.

### Sync frequency

ADP data refreshes automatically every few hours. Trigger a manual sync from **Settings → Integrations → ADP → Sync now**.

### Common workflows

**Day‑1 onboarding.** *Trigger: Hire date. Actions: create IdP account, assign apps by department, ship equipment, notify manager.*

**Offboarding on termination.** *Trigger: Termination date. Actions: revoke sessions, remove app access, open equipment pickup request.*

**Company‑aware approvals.** *Condition: Requester's company = "Siit US Inc." → Approver = US Finance lead.*

**Rehire welcome‑back.** *Trigger: Rehire date. Actions: restore standard app bundle, DM manager with rehire checklist.*

### Troubleshooting

**Consent screen doesn't redirect to Siit.** Close the popup and re‑open the Siit app in **ADP Marketplace → My Apps**. If consent was granted but Siit didn't pick it up, contact Siit support — we can trigger a manual sync.

**Workers missing.** Check the subscription scope in ADP Marketplace — some installs default to a single company. Expand the scope to include all companies, then re‑sync.

**Wrong manager or department.** These are pulled from ADP's current assignments. Confirm the worker's **Work Assignments** in ADP; Siit reflects what's active there.

**"Consent expired" error.** ADP consents can be time‑limited for some tenants. Re‑grant consent from **ADP Marketplace → My Apps → Siit → Manage**.