> 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/ukg-pro.md).

# UKG Pro

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

### What you get

* **Live People directory** — UKG Pro employees appear in Siit with role, department, manager, and lifecycle dates.
* **Lifecycle triggers** — Hire date, Termination date, and Birthday flow into Siit as workflow triggers.
* **Manager resolution** — UKG Pro's reporting structure powers auto‑selected approvers in workflows.
* **Multi‑entity support** — for multi‑company UKG tenants, each worker's company / legal entity is attached.

### What syncs from UKG Pro

| Category        | Fields                                                         |
| --------------- | -------------------------------------------------------------- |
| Identity        | First name, last name, preferred name, work email, employee ID |
| Role            | Job title, department, cost center                             |
| Org structure   | Manager, work location, company / legal entity                 |
| Employment      | Worker type, status                                            |
| Lifecycle dates | Hire date, termination date, date of birth                     |

Work email is the canonical identifier. Compensation and payroll data are not synced into Siit.

### Before you connect

* A UKG Pro admin with API access enabled and permission to create service credentials.
* Work email populated on every active worker in UKG Pro.

### Connect UKG Pro

1. In UKG Pro, generate API credentials (typically a service account with the relevant API role) with read access to employee data.
2. In Siit, go to **Settings → Integrations**, find **UKG Pro** in the HRIS section, and click **Connect**.
3. Enter the credentials and your UKG Pro tenant URL, then click **Authorize**.
4. Review the imported workers and field mapping, then click **Finish setup**.

UKG Pro tenants vary in their API configuration. For the recommended setup for your tenant, reach out to support via the in‑app chat.

### After the connection

* Confirm your **People list** matches UKG Pro's active workforce.
* In **Settings → People → Fields**, set UKG Pro as the source of truth for HR‑owned fields if you're also connected to an IdP.
* Build a Day‑1 onboarding workflow using the Hire date trigger.

### Sync frequency

UKG Pro data refreshes automatically every few hours. Trigger an immediate refresh from **Settings → Integrations → UKG Pro → Sync now**.

### Common workflows

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

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

### Troubleshooting

**Employees missing.** Only active workers and upcoming hires sync by default. Confirm status and work email in UKG Pro. Service account scope can also restrict what's visible — check with your UKG admin.

**Manager field empty.** In UKG Pro, check the employee has a manager assigned in their job assignment.

**"Invalid credentials" on connect.** The service account password expired or was rotated. Update Siit with new credentials.