Deel

Connect Deel to Siit to sync your global workforce — employees, EOR workers, and contractors — and drive onboarding, offboarding, and request automation from Deel's lifecycle events.

What you get

• Unified global directory — Deel employees (EOR), direct employees, and contractors all appear in Siit, each with the right worker type.

• Lifecycle triggers — Start date, End date, Probation end, and Birthday flow into Siit as workflow triggers.

• Contract and entity context — country, legal entity, and contract type are synced so you can route and approve by location or contract.

• Manager resolution — Deel's manager assignments power auto‑selected approvals.

• Contractor‑aware workflows — differentiate between employees and contractors in every automation (e.g., skip laptop shipping for contractors).

What syncs from Deel

Category	Fields
Identity	Full name, preferred name, work email, Deel Worker ID
Role	Job title, seniority
Org structure	Manager, team, country, legal entity / Deel entity
Employment	Worker type (EOR Employee, Direct Employee, Contractor), contract status (active, pending, ended)
Lifecycle dates	Start date, end date, probation end, date of birth
Custom	Selected custom Deel fields

Work email is the canonical identifier.

Before you connect

• You'll need a Deel admin (Organization Admin or IT Admin) account.

• Make sure work email is set on every worker record in Deel. For EOR employees, this is the corporate email you issue them — not their Deel login.

• Decide whether Deel or your IdP is the source of truth for overlapping fields.

Connect Deel

1. In Deel, generate an API token:

   • Go to Organization Settings → Developer → API Keys.

   • Click Generate new token, name it "Siit", and grant the scopes people:read, contracts:read, organizations:read.

   • Copy the token — it's shown only once.

2. In Siit, go to Settings → Integrations.

3. Find Deel in the HRIS section and click Connect.

4. Paste the Deel API token and click Authorize.

5. Siit runs an initial import and shows a preview.

6. Review field mapping (including the worker type mapping — confirm how you want EOR vs Direct Employee vs Contractor reflected in Siit's Employment Type field).

7. Click Finish setup.

Tip — If you only want employees (not contractors) synced into Siit, apply a filter on Worker Type in the mapping step.

After the connection

• Check your People list — confirm the counts by worker type match Deel's "People" view.

• Set source of truth — in Settings → People → Fields, pick Deel for country, contract type, and legal entity.

• Map custom fields — add any custom Deel fields you want in Siit.

• Build workflows — Deel customers often start with offboarding automation driven by contract end date.

Sync frequency

Deel data refreshes every few hours. Force an immediate refresh from Settings → Integrations → Deel → Sync now.

Common workflows

Global Day‑1 onboarding. Trigger: Start date. Actions: create IdP account, assign apps by team, ship equipment if Worker Type = Employee, send country‑specific welcome.

Contractor offboarding. Trigger: End date, Condition: Worker Type = Contractor. Actions: revoke app access, notify manager, close Slack access.

Entity‑specific approval. Condition: Requester's entity = "Siit SAS" → Approver = French HR lead.

Pre‑boarding email 2 weeks before start. Trigger: Start date − 14 days. Action: email manager with a pre‑boarding checklist specific to the hire's country.

Troubleshooting

Workers missing. Check the worker's contract status in Deel — only active and upcoming contracts are synced by default. Also confirm work email is set.

Contractor vs employee mis‑labeled. Open Settings → Integrations → Deel → Mapping and confirm the Worker Type → Employment Type mapping.

Manager field empty. In Deel, confirm the worker has a reporting manager under their profile. Siit reads from that field.

"Unauthorized" error. The API token was revoked or is missing a scope. Generate a new one with the three scopes listed above and update Siit.