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

# Lucca

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

### What you get

* **Live People directory** — Lucca employees appear in Siit with role, manager, department, and lifecycle dates.
* **Lifecycle triggers** — Hire date, End date, Work anniversary, and Birthday flow into Siit as workflow triggers.
* **Manager resolution** — Lucca's reporting structure powers auto‑selected approvers in workflows.
* **Pre‑hires** — future employees with a hire date in Lucca appear in Siit ahead of Day 1.

### What syncs from Lucca

| Category        | Fields                                          |
| --------------- | ----------------------------------------------- |
| Identity        | First name, last name, work email, employee ID  |
| Role            | Job title, department                           |
| Org structure   | Manager, establishment / location, legal entity |
| Employment      | Contract type, status                           |
| Lifecycle dates | Hire date, contract end date, date of birth     |

Work email is the canonical identifier across systems.

### Before you connect

* A Lucca admin to generate an API key.
* Work email populated for every active employee in Lucca.

### Connect Lucca

1. In Lucca, generate an API key with read access to the employee directory.
2. In Siit, go to **Settings → Integrations**, find **Lucca** in the HRIS section, and click **Connect**.
3. Enter your Lucca subdomain and the API key, then click **Authorize**.
4. Review the imported people and field mapping, then click **Finish setup**.

For the detailed walkthrough, see our Help Center guide: [Lucca integration setup](https://help.siit.io/lucca-integration).

### After the connection

* Confirm your **People list** matches your active + upcoming Lucca employees.
* In **Settings → People → Fields**, set Lucca 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

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

### Common workflows

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

**Offboarding on contract end.** *Trigger: Contract end date. Actions: revoke sessions, remove app access, equipment pickup, notify manager.*

### Troubleshooting

**Employees missing.** Only active employees and future hires sync by default. Confirm status and work email in Lucca.

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

**"Invalid credentials" on connect.** The API key was revoked. Generate a new one in Lucca and update Siit.