# 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**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siit.io/integrations/hris/adp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.