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

# Justworks

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

### What you get

* **Live People directory** — Justworks employees and contractors appear in Siit with role, department, manager, and lifecycle dates.
* **Lifecycle triggers** — Start date, Termination date, and Birthday flow into Siit as workflow triggers.
* **Manager resolution** — Justworks' reporting structure powers auto‑selected approvers in workflows.
* **Employee + contractor coverage** — both worker types sync, with the type preserved as a Siit attribute.

### What syncs from Justworks

| Category        | Fields                                         |
| --------------- | ---------------------------------------------- |
| Identity        | First name, last name, work email, employee ID |
| Role            | Job title, department                          |
| Org structure   | Manager, work location                         |
| Employment      | Worker type (Employee / Contractor), status    |
| Lifecycle dates | Start date, termination date, date of birth    |

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

### Before you connect

* A Justworks admin with permission to authorize integrations.
* Work email populated on every active worker in Justworks.

### Connect Justworks

1. In Siit, go to **Settings → Integrations**, find **Justworks** in the HRIS section, and click **Connect**.
2. Sign in with your Justworks admin account and approve the requested read scopes.
3. Review the imported people and field mapping (including Worker Type → Employment Type) and click **Finish setup**.

Need a more detailed walkthrough? Reach out to support via the in‑app chat.

### After the connection

* Confirm your **People list** matches Justworks' active workforce.
* In **Settings → People → Fields**, set Justworks 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 Start date trigger.

### Sync frequency

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

### Common workflows

**Day‑1 onboarding.** *Trigger: Start date. Actions: create IdP account, assign apps by department, ship equipment if Worker Type = Employee, DM manager.*

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

**Contractor onboarding.** *Trigger: Start date, Condition: Worker Type = Contractor. Actions: create limited IdP account, contractor app bundle only.*

### Troubleshooting

**Workers missing.** Only active workers and upcoming hires sync by default. Confirm status and work email in Justworks.

**Contractor vs employee mis‑labeled.** Open **Settings → Integrations → Justworks → Mapping** and check Worker Type → Employment Type.

**Manager field empty.** In Justworks, check the employee has a manager set on their profile.

**Connection shows "needs reauthorization".** Reconnect from **Settings → Integrations → Justworks**.