Deel
Deel is a global HR and payroll platform. It helps businesses hire, pay employees, manage contracts, taxes, and legal compliance for personnel in multiple countries, without the need to establish a legal entity.
- Getting Started
- Roles & Permissions
- People Management
- Time Off
- Engage
- Compensation
- Talent Management
- Workforce Planning
- Reports
- Integrations & API
Getting Started (Deel HR)
- Create/confirm your client org and baseline settings.
- Understand the “People” hub (workers, tasks, structure).
- Set notifications + learn where support/training lives.
- Have a clean first-week rollout checklist.
1) Purpose, who it’s for, and where to click
This tab helps you get into Deel as a client and set the minimum foundation so the rest of Deel HR features make sense. The goal is to reduce setup mistakes and make your first week in the platform predictable.
- Who it’s for: HR admins, ops, finance/people ops who will manage workers and HR workflows.
- When to use: before importing workers, enabling HR features, or inviting managers.
- Where in navigation: Help Center → For business → Account Access → Getting Started.
- Related tabs: People Management (tasks/workflows), Roles & Permissions, Integrations & API.
- Outcome: you can log in reliably, find core menus, and know “what to do next”.
2) Mental model (first-week flow)
Think of Deel HR as a single place to store worker records and drive repeatable HR processes (tasks, approvals, documents, time off, and reporting). Your best first step is to stabilize access + org settings, then move to People and workflows.
- Confirm account + organization context (right workspace/org).
- Set notifications so you don’t miss approvals and tasks.
- Open People hub to understand worker records + actions.
- Decide your rollout: pilot group → expand.
- Only then: connect integrations + reporting dashboards.
3) Objects & terms you’ll see early
These are common labels you’ll see across Getting Started and adjacent People workflows. Knowing these reduces confusion when you follow help articles or train others.
- Client account / Organization: the business entity context you’re managing.
- Workspace: where you switch context inside Deel (varies by UI).
- Worker profile: a person record (may be merged if duplicates exist).
- Tasks / Onboarding checklist: operational steps assigned to workers/admins.
- Inbox / Notifications: where work items and updates show up.
- Academy: official training entry point.
4) Lifecycle / state machine
Getting Started itself is not a strict state machine, but you can treat it as a readiness ladder: access → visibility → process → scale. This helps you avoid “integrations first” chaos.
- State A: Can log in + confirm org context.
- State B: Notifications configured + Inbox understood.
- State C: People hub opened + basic worker actions understood.
- State D: Pilot workflow running (tasks/time off/docs) for a small group.
- Transition condition: move to next state only when the previous produces predictable outcomes.
5) Core jobs-to-be-done (JTBD)
Your first wins are small: stable access, predictable alerts, and a repeatable routine for worker operations. Use these jobs as your “starter backlog”.
- Sign up / complete client onboarding and confirm org setup.
- Find and use Inbox for operational follow-ups.
- Configure notifications for approvals and key events.
- Identify where People actions live (tasks, structure, edits).
- Train one manager on their responsibilities and views.
- Locate official learning resources for your team.
6) Happy path workflow #1 — “Day 0: admin readiness”
Use this when you’ve just created access and want to be confident you won’t miss requests or approvals.
- Log in and confirm you’re in the correct organization/workspace.
- Open client Inbox and skim what types of items appear there.
- Open notification settings and enable the alerts you need for daily ops.
- Write down your daily routine: Inbox → approvals → tasks → escalations.
- Invite one teammate (or manager) to validate access works end-to-end.
- Bookmark 2–3 help articles you’ll reuse (e.g., notifications, Inbox, Academy).
7) Happy path workflow #2 — “Week 1: pilot rollout”
Use this when you want to roll Deel HR out safely (small group first), before turning it into your system of record.
- Pick a pilot group (e.g., one team or 5–20 workers).
- In People, confirm each pilot worker has a single clean profile (merge duplicates if needed).
- Assign a small onboarding checklist or tasks to validate task flows.
- Validate one approval flow (e.g., time off or document request) from worker → manager → admin.
- Capture gaps: missing fields, unclear owners, permissions problems.
- Update your internal SOP and expand to the next group.
- Schedule a 15-minute weekly review: errors, approvals latency, missing data.
8) Decision points (A/B)
These choices shape your rollout speed and how many issues you’ll chase later.
| Decision | If A… | If B… |
|---|---|---|
| Pilot vs big-bang rollout | Pilot first → fewer surprises, slower start | All at once → faster adoption, higher risk |
| Notifications strictness | More alerts → fewer misses, more noise | Fewer alerts → calmer, risk of missed items |
| Owner of daily Inbox | Single owner → clear accountability | Shared inbox → coverage, can be ignored |
| Training approach | Short weekly enablement → steady adoption | One long session → faster, less retained |
9) Common mistakes + guardrails
Most early problems come from unclear ownership and skipping the pilot. Use these guardrails to stay out of the ditch.
- Mistake: inviting people before roles are defined → Avoid: set Roles & Permissions first.
- Mistake: ignoring Inbox/notifications → Avoid: daily routine + alert hygiene.
- Mistake: duplicate worker profiles → Avoid: merge profiles before scaling.
- Mistake: no internal SOP → Avoid: write a 1-page “how we use Deel”.
- Mistake: integrations too early → Avoid: stabilize People + workflows first.
10) What good looks like + checklists + practice lab + official docs
Use this as your “definition of done” for Getting Started. If you can check these off, you’re ready to move into People workflows and HR modules.
What good looks like
- Admins can access the right org every time.
- Inbox and notifications are monitored daily.
- At least 1 manager has verified their view + responsibilities.
- Pilot group completed a small workflow end-to-end.
Checklist: Pre-check
- Correct org/workspace confirmed
- Notification settings reviewed
- Inbox understood and owned
- Pilot group selected
- Internal owners assigned
Checklist: Post-check
- One workflow completed end-to-end
- Issues logged and prioritized
- Training links shared internally
- Next rollout group scheduled
- Weekly review cadence set
Practice lab (5–15 min)
Goal: set up a daily operating rhythm so work doesn’t get lost.
- Open Inbox and identify 2 item types you expect to handle.
- Adjust notifications to ensure you’ll see approvals/tasks.
- Write a 4-step daily routine and share it with a teammate.
- Bookmark the help articles you used today.
Official docs links (titles)
- How to Create a Deel Account as a Client and Complete the Onboarding
- How clients can use Deel Inbox
- How Can Clients Manage Notifications?
- Getting Started with Deel Academy
Roles & Permissions
- Know the key admin roles (Org Admin, Group Admin, Manager).
- Assign manager roles the “safe” way.
- Avoid over-permissioning payroll/HR data.
- Build a repeatable access review routine.
1) Purpose, who it’s for, and where to click
Roles determine who can see and do what inside Deel HR. The goal is simple: give people exactly what they need to do their job, and nothing extra.
- Who it’s for: Org Admins, HR admins, Ops leads who manage access.
- When to use: before inviting managers, enabling workflows, or sharing reports.
- Where in navigation: Help Center → For business → Account Access → Roles & Permissions.
- Related tabs: People Management (manager assignment), Reports, Integrations & API (SSO/SCIM).
- Outcome: clean role mapping with fewer “I can’t see X” messages.
2) Mental model (access layers)
Think in layers: organization-wide admins, group-scoped admins, and people-managers. Start broad (Org Admin), then narrow (Group Admin), then assign manager roles only where needed.
- Define the minimum set of admins.
- Segment by group when possible (reduces risk).
- Assign managers for approvals and direct reports.
- Review access regularly (especially after org changes).
3) Objects & terms
These terms are referenced in the official articles about roles. Use them as your shared vocabulary with stakeholders.
- Org Admin: organization administrator permissions (broad control).
- Group Admin: group-scoped admin permissions (narrower scope).
- Manager role: manager responsibilities and access for direct reports.
- Direct reports: workers tied to a manager relationship.
- Approval flows: actions (like time off) that route to managers/admins.
4) Lifecycle / state machine
Access management isn’t a single setup step; it’s ongoing. Treat role assignment as a lifecycle: request → grant → verify → review → revoke.
- Requested: new hire/manager needs access.
- Granted: role assigned (Org Admin / Group Admin / Manager).
- Verified: user can see required pages and complete a test action.
- Reviewed: monthly/quarterly access audit.
- Revoked: remove access when role changes or offboarding occurs.
5) Core jobs-to-be-done
These are the common tasks you’ll repeat as your company grows.
- Assign manager roles across teams.
- Explain what managers can do on Deel (and what they can’t).
- Grant group-admin permissions for delegated HR ops.
- Keep Org Admin list minimal and up-to-date.
- Handle escalations: “missing access” vs “wrong permissions”.
- Prepare for scale via SSO/SCIM (if applicable).
6) Happy path workflow #1 — Assign a manager role
Use this when a new manager needs to approve requests or manage their team inside Deel.
- Confirm the person has a user account in the correct organization.
- Identify who their direct reports are (worker relationships/structure).
- Assign the manager role using the organization settings flow.
- Ask the manager to log in and confirm they can see their team view.
- Run a test: submit one request (e.g., time off) from a direct report.
- Verify the manager can approve/decline and you receive the expected notification.
7) Happy path workflow #2 — Set up a minimal admin model
Use this when you’re starting Deel HR and want to avoid a messy “everyone is admin” situation.
- List the admin jobs: HR operations, reporting, approvals, integrations.
- Map jobs to roles: Org Admin for core owners; Group Admin for delegated work.
- Keep Org Admin count as low as possible (principle of least privilege).
- Document ownership: who approves what, who maintains structure, who audits access.
- Invite users and assign roles based on the job map.
- Do a 10-minute verification with each role (can they do their job, nothing extra?).
- Schedule an access review cadence (monthly or quarterly).
8) Decision points (A/B)
These are the most common access decisions that affect security and speed.
| Decision | If A… | If B… |
|---|---|---|
| Org Admin vs Group Admin | Org Admin → faster fixes, higher risk | Group Admin → safer, needs clearer structure |
| Manager scope | Strict direct reports → safer, more setup | Broad visibility → easier, privacy risk |
| Access reviews | Monthly → tight control, more overhead | Quarterly → less overhead, slower cleanup |
| Self-serve vs ticketed access | Self-serve → faster, needs guardrails | Ticketed → controlled, slower turnaround |
9) Common mistakes + guardrails
Most permission incidents are accidental. Treat these as “never again” rules.
- Mistake: too many Org Admins → Avoid: limit to 1–3 owners.
- Mistake: managers can’t approve → Avoid: verify role + direct reports mapping.
- Mistake: unclear group boundaries → Avoid: define groups before delegating.
- Mistake: no audit trail → Avoid: log role changes (who/when/why).
- Mistake: access not removed → Avoid: revoke on role change/offboarding.
10) What good looks like + checklists + practice lab + official docs
Use this section as your “permissions done right” standard.
What good looks like
- Admins are minimal and clearly named.
- Managers only see what they need for their teams.
- Role changes are reviewed and documented.
- Access removal is part of offboarding.
Checklist: Pre-check
- Define admin jobs
- Define groups (if used)
- Identify managers
- Set verification steps
- Choose review cadence
Checklist: Post-check
- Test approval works (e.g., time off)
- Confirm visibility is correct
- Document owners and escalations
- Schedule access review
- Create offboarding revoke step
Practice lab (5–15 min)
Goal: assign one manager role and verify approvals work.
- Pick one manager and one direct report.
- Assign the manager role.
- Have the direct report submit a request (time off is a common test).
- Verify manager sees and can act on the request.
Official docs links (titles)
- How to Assign Manager Roles in Your Organization
- Understanding your role as a manager on Deel
- Group Administrator (Group Admin) Permissions Explained
- Organization Administrator (Org Admin) Permissions Explained
People Management
- Understand worker profiles and key People actions.
- Import/direct employee setup basics (HRIS contracts).
- Tasks, onboarding checklists, and Workflow Builder basics.
- Keep data clean (merge/delete/bulk edit).
1) Purpose, who it’s for, and where to click
People Management is your operational hub for maintaining worker records and running repeatable HR work (tasks, onboarding steps, and automation). The goal is consistent data and fewer manual follow-ups.
- Who it’s for: HR admins, People Ops, onboarding owners.
- When to use: whenever you add/update workers, assign tasks, or build automation.
- Where in navigation: Help Center → For business → Organization & Group Management → People Management.
- Related tabs: Roles & Permissions, Time Off, Reports, Integrations & API.
- Outcome: clean worker directory + repeatable workflows that scale.
2) Mental model (People as system-of-action)
Treat People as your “source of actions” even if it’s not your only source of truth yet. Profiles hold data; tasks and workflows drive work; structure/relations control visibility and manager flows.
- Create or import worker profiles.
- Collect required worker information (fields, forms, documents).
- Assign tasks/onboarding checklist.
- Automate follow-ups with Workflow Builder.
- Maintain structure and relationships for reporting/approvals.
3) Objects & terms
These terms appear frequently in People Management articles and are the building blocks for HR workflows.
- Worker profile: the record for a worker inside Deel.
- Direct employee (HRIS) contract: a setup path for direct employees.
- Mass import: bulk creation for many direct employees.
- Tasks / onboarding checklist: assigned operational steps.
- Workflow Builder: automation for workflow tasks.
- Organization structure & worker relations: grouping and relationships used in People directory and org chart.
4) Lifecycle / state machine (worker record health)
People data typically moves through a predictable health lifecycle. Keeping profiles “healthy” improves approvals, analytics, and manager routing.
- Created: profile exists (manual or import).
- Enriched: required fields collected (worker info, demographics if enabled).
- Operational: tasks assigned; onboarding checklist running.
- Structured: manager and relations set; org structure defined.
- Maintained: bulk edits and modification reasons/change log used when needed.
- Cleaned up: duplicates merged; obsolete profiles deleted (when appropriate).
5) Core jobs-to-be-done
Use these as your standard playbook for day-to-day People Ops inside Deel.
- Create a direct employee (HRIS) contract/profile.
- Mass import direct employees.
- Collect worker information and required fields.
- Create and manage tasks for workers.
- Set up automation workflows / Workflow Builder tasks.
- Maintain org structure and worker relations.
- Bulk edit worker and payroll contract info (when needed).
6) Happy path workflow #1 — Add workers (manual → ready)
Use this when you’re adding a small number of workers and want a consistent “ready to operate” result.
- Create the worker profile / direct employee setup as needed.
- Collect worker information (required fields and any enabled demographics fields).
- Assign tasks and/or a customized onboarding checklist.
- Set manager roles and worker relations (so approvals route correctly).
- Run one automated task with Workflow Builder (e.g., reminder or document request).
- Verify the worker can complete their assigned steps and you can track status.
7) Happy path workflow #2 — Bulk import + cleanup
Use this when you’re onboarding many direct employees and want to avoid duplicates and broken manager routing.
- Prepare your import data with consistent identifiers (emails/IDs).
- Run mass import for direct employees.
- Spot-check 5–10 imported profiles for field completeness.
- Merge any duplicate worker profiles discovered.
- Assign onboarding tasks/checklists in batches.
- Set organization structure and worker relations for manager routing.
- Use bulk edit for missing/incorrect fields where applicable.
- Document a repeatable import SOP for next time.
8) Decision points (A/B)
Pick the option that matches your scale and data maturity.
| Decision | If A… | If B… |
|---|---|---|
| Manual add vs mass import | Manual → fewer errors, slower | Import → fast, needs cleanup plan |
| Tasks vs Workflow Builder first | Tasks → simple, manual follow-up | Workflow Builder → scalable, needs design |
| Structure now vs later | Now → better approvals/reporting | Later → faster start, more rework |
| Delete vs merge duplicates | Merge → preserves history | Delete → risky if referenced elsewhere |
9) Common mistakes + guardrails
These issues are common when building a People hub quickly. Use the guardrails to keep data stable.
- Mistake: missing manager mapping → Avoid: set relations during onboarding.
- Mistake: duplicates after import → Avoid: standard identifiers + merge early.
- Mistake: tasks with unclear owners → Avoid: define task ownership in checklist.
- Mistake: automations without testing → Avoid: pilot Workflow Builder on one team.
- Mistake: bulk edits without audit → Avoid: use modification reasons/change log if enabled.
10) What good looks like + checklists + practice lab + official docs
If you can check these off, People Management is stable enough to scale.
What good looks like
- Profiles are unique (no duplicates).
- Required fields are collected consistently.
- Tasks/checklists are used for every onboard.
- Structure/relations are maintained for approvals.
Checklist: Pre-check
- Decide import vs manual
- Define required fields
- Define onboarding tasks
- Assign data owner
- Choose pilot group
Checklist: Post-check
- Spot-check profile quality
- Merge duplicates
- Verify manager routing
- Test one automation
- Document SOP
Practice lab (5–15 min)
Goal: create one clean worker record and run a tiny workflow.
- Create (or pick) one worker profile.
- Collect/confirm core fields.
- Assign one onboarding task and one reminder automation.
- Set a manager relation and validate the manager can see the worker.
Official docs links (titles)
- How to Create a Direct Employee (HRIS) Contract on Deel
- How to Mass Import Direct Employees into Deel
- How to Merge Worker Profiles
- How to Delete a Worker Profile on Deel
- Setting Up Automation Workflows on Deel
- Customized Onboarding Checklist
- How to Create and Manage Tasks for Organization Workers
- How to Configure Organization Structure and Worker Relations
- How Clients Can Collect Worker Information
- How To Automate Workflow Tasks With Workflow Builder
Time Off
- Create policies and approval rules.
- Review/manage requests consistently.
- Adjust balances correctly (with audit mindset).
- Know the contractor vs employee expectation boundary.
1) Purpose, who it’s for, and where to click
Time Off helps you define how requests are submitted, routed, and tracked. The goal is consistent approvals and accurate balances that managers and HR trust.
- Who it’s for: HR admins, People Ops, managers who approve time off.
- When to use: when setting policies, approving requests, or correcting balances.
- Where in navigation: Help Center → For business → Time Off.
- Related tabs: Roles & Permissions (approvers), People Management (manager mapping), Reports (tracking).
- Outcome: predictable approvals + reliable time off records.
2) Mental model (policy → approval → balance)
Time off is a loop: policies define entitlements; approval rules route requests; approved requests update balances. Keep the loop tight and you’ll avoid disputes.
- Create or customize a time off policy.
- Set approval policy (who approves, in what order).
- Workers submit requests.
- Approvers review and decide.
- Balances update; admins adjust only when needed.
3) Objects & terms
These are the key pieces referenced across the official time off articles.
- Time off policy: defines entitlement and rules.
- Approval policy: defines who can approve time off.
- Request: a submitted time off entry awaiting action.
- Balance: remaining entitlement after usage/adjustments.
- Direct employee time off: time off management path for direct employees.
- Contractor time off expectation: may differ; confirm policy approach.
4) Lifecycle / state machine (request states)
Requests typically move through a simple state flow. Use this to standardize how managers respond and how HR audits issues.
- Draft/Submitted: worker submits a request.
- Pending: waiting on approval policy chain.
- Approved: accepted and applied to balance.
- Declined: rejected; balance unchanged.
- Adjusted: admin correction applied to balance (with reason).
5) Core jobs-to-be-done
These are the top repeatable admin/manager actions in Time Off.
- Create a custom time off policy for workers.
- Configure time off approval policies.
- Review and manage employee time off requests.
- Manage direct employee time off requests (if applicable).
- Adjust time off balances when corrections are needed.
- Clarify policy stance for contractors (where relevant).
6) Happy path workflow #1 — Set up Time Off (admin)
Use this when you’re enabling Time Off for the first time and want a safe default setup.
- Decide your policy approach (standard vs custom policy).
- Create the time off policy and confirm entitlement logic.
- Configure the approval policy (manager, HR, or both).
- Confirm managers are correctly assigned in People/structure.
- Run a test request with a pilot worker.
- Verify the request routes to the right approver and updates balance when approved.
7) Happy path workflow #2 — Process requests weekly (ops routine)
Use this as your weekly operating rhythm to prevent backlogs and disputes.
- Check pending requests (daily or on a fixed cadence).
- Validate dates, overlaps, and required approvals.
- Approve/decline based on policy and team coverage needs.
- For corrections, adjust balances with a clear internal reason.
- Message workers when declines happen (include next step).
- Spot-check balances for anomalies (large negative/positive changes).
- Review approver performance (stuck approvals) and fix manager mappings.
8) Decision points (A/B)
These decisions control how strict your time off process is.
| Decision | If A… | If B… |
|---|---|---|
| Approval chain | Manager-only → fast, less oversight | Manager + HR → safer, slower |
| Policy complexity | Simple policy → easy adoption | Custom policy → accurate, more setup |
| Balance adjustments | Rare, controlled → fewer disputes | Frequent → risk of inconsistency |
| Contractor time off | Offer policy → goodwill, cost/complexity | No policy → simpler, expectations must be clear |
9) Common mistakes + guardrails
Time off failures are usually routing or policy ambiguity. Fix these early and everything gets easier.
- Mistake: wrong approver routing → Avoid: verify manager mapping and approval policy.
- Mistake: policies not documented internally → Avoid: publish a 1-page policy summary.
- Mistake: adjusting balances without context → Avoid:
- Mistake: ignoring stuck requests → Avoid:
- Mistake: unclear contractor expectations → Avoid:
10) What good looks like + checklists + practice lab + official docs
Use these as your time off quality bar and onboarding material for managers.
What good looks like
- Managers approve within an agreed timeframe.
- Balances match policy expectations.
- Adjustments are rare and traceable.
- Workers understand how to request time off.
Checklist: Pre-check
- Policy defined
- Approvers assigned
- Manager mapping verified
- Pilot worker selected
- Internal policy summary drafted
Checklist: Post-check
- Test request approved
- Balance updated correctly
- Escalation rule set
- Managers trained
- Audit cadence planned
Practice lab (5–15 min)
Goal: validate policy + approvals in one short test.
- Create or pick an existing time off policy.
- Set an approval policy (manager).
- Submit a test request for a pilot worker.
- Approve it and confirm the balance updates.
Official docs links (titles)
- How to Create a Custom Time Off Policy for Workers
- How to Configure Time Off Approval Policies
- How to Review and Manage Employee Time Off Requests
- How to Manage Direct Employee Time Off Requests
- How to Adjust Time Off Balances for Your Workers
- Do Clients Have to Offer Independent Contractors Time Off?
Engage
- Understand Engage sub-areas (Goals, Learning, Career, Surveys, Admin/User mgmt).
- Start with one simple program (pilot) before scaling.
- Define ownership: HR vs managers vs employees.
- Measure adoption with lightweight checks.
1) Purpose, who it’s for, and where to click
Engage is where you run programs that support employee growth and feedback (as surfaced in the Engage navigation areas like Goals, Learning, Career, and Surveys). The goal is to improve engagement with repeatable, trackable routines.
- Who it’s for: HR/People Ops, team leads, managers running growth routines.
- When to use: when you want consistent goal cycles, learning tracking, career planning, or surveys.
- Where in navigation: Help Center → For business → Deel HR → Engage.
- Related tabs: Workforce Planning (planning + capacity), People Management (manager mapping), Reports (analytics).
- Outcome: one pilot program running end-to-end with clear owners.
2) Mental model (programs + cycles)
Treat Engage as a set of “cycles”: define a program (e.g., goals or a pulse survey), launch to a population, collect updates, then review outcomes and iterate.
- Pick one module (Goals or Surveys) for a pilot.
- Define who participates and who owns follow-up.
- Run a short cycle (2–4 weeks) before scaling.
- Review results and adjust prompts/process.
3) Objects & terms
Engage is organized into sub-areas in the official navigation. Use these as your mental “tabs within the tab”.
- Goals: goal-setting and tracking routines.
- Learning: learning programs or learning tracking area.
- Career: career development planning area.
- Surveys: feedback collection (pulse/engagement surveys).
- Engage admin and user management: who can create/manage programs.
4) Lifecycle / state machine
Engage work tends to follow a simple lifecycle that repeats. Keeping the lifecycle consistent improves adoption.
- Designed: program defined (scope, participants, owners).
- Launched: participants notified and invited.
- Active: updates/responses collected during the cycle.
- Reviewed: managers/HR review results and decide actions.
- Iterated: program refined for the next cycle.
5) Core jobs-to-be-done
These are the most common “what are we actually doing?” jobs for Engage.
- Launch a basic goals cycle for one team.
- Collect feedback using a simple survey.
- Define learning focus areas for a quarter.
- Support career conversations with a lightweight template/process.
- Set who can administer Engage programs and who can participate.
- Run a recurring cadence (monthly/quarterly) with consistent reminders.
6) Happy path workflow #1 — Run a pilot survey cycle
Use this when you want a low-risk way to start using Engage and prove value quickly.
- Pick a pilot group (one team or department).
- Define the survey goal (e.g., onboarding feedback, weekly pulse).
- Decide who reviews results and who owns follow-up actions.
- Launch the survey and set a deadline.
- Monitor response rates and send reminders (if available in your process).
- Review results and decide 1–2 actions to take.
- Communicate outcomes back to participants (close the loop).
7) Happy path workflow #2 — Start a goals cadence with managers
Use this when you want managers to consistently set and review goals with their teams.
- Pick a simple cycle length (e.g., monthly check-in or quarterly goals).
- Define what “good goals” look like (2–4 goals per person max).
- Assign manager ownership for check-ins and updates.
- Launch the cycle to the pilot team.
- Hold a mid-cycle check-in and capture blockers.
- End-cycle review: what was achieved and what changes next cycle.
- Scale to the next group only after the pilot is stable.
8) Decision points (A/B)
These decisions control adoption and the “manager burden” level.
| Decision | If A… | If B… |
|---|---|---|
| Pilot size | Small → fast iteration | Large → faster impact, higher risk |
| Program owner | HR-owned → consistency | Manager-owned → relevance, uneven quality |
| Cycle length | Short → momentum, more overhead | Long → less overhead, slower learning |
| Feedback transparency | Share outcomes → trust | Keep internal → easier, less trust |
9) Common mistakes + guardrails
Engage fails when people don’t see outcomes. Keep your loop tight.
- Mistake: launching too many programs → Avoid: one pilot at a time.
- Mistake: no owner for follow-ups → Avoid: assign action owners before launch.
- Mistake: collecting feedback then silence → Avoid: always share outcomes.
- Mistake: manager overload → Avoid: keep cycles simple and time-boxed.
- Mistake: unclear admin rights → Avoid: define Engage admin/user management rules.
10) What good looks like + checklists + practice lab + official docs
Use these to keep Engage simple and measurable.
What good looks like
- One stable program cycle running.
- Clear owners for review and follow-up.
- Participants see outcomes and actions.
- Managers can run cadence without extra tooling.
Checklist: Pre-check
- Select pilot group
- Define program goal
- Assign owners
- Set cycle length
- Plan communications
Checklist: Post-check
- Response/update rate reviewed
- Actions assigned
- Outcomes shared
- Next iteration planned
- Scale decision made
Practice lab (5–15 min)
Goal: design a pilot cycle on paper (even before clicking around).
- Pick: Goals or Surveys as your pilot.
- Write the cycle: start date, end date, owners, participants.
- Define one success metric (e.g., 70% participation).
- Define one follow-up action you will commit to after the cycle.
Official docs links (navigation sections)
- Engage → Goals
- Engage → Learning
- Engage → Career
- Engage → Surveys
- Engage → Engage admin and user management
Compensation
- Set up job architecture and compensation bands.
- Run a compensation cycle with budgets.
- Handle multi-currency planning (if used).
- Control access with admins.
1) Purpose, who it’s for, and where to click
Compensation helps you structure pay decisions and run compensation cycles consistently. The goal is to reduce ad-hoc decisions and make cycles more auditable (bands, budgets, admins, currencies).
- Who it’s for: HR/People Ops, finance partners, comp administrators.
- When to use: during salary review cycles, leveling, or budget planning.
- Where in navigation: Help Center → For business → Deel HR → Compensation.
- Related tabs: People Management (job/worker data), Reports (analysis), Roles & Permissions.
- Outcome: one repeatable cycle that managers can follow without chaos.
2) Mental model (architecture → bands → cycle)
A stable compensation program typically starts with structure, then runs cycles. Job architecture sets the map, bands set ranges, cycles execute decisions with budgets and approvals.
- Add job architectures (roles/levels).
- Set compensation bands aligned to those jobs/levels.
- Add currencies if you operate globally.
- Create a compensation cycle with budgets.
- Assign admins and run the cycle.
3) Objects & terms
These terms come directly from the official Compensation article titles and help you navigate the feature set.
- Compensation bands: structured ranges for roles/levels.
- Compensation cycles: the periodic review workflow.
- Job architectures: the role/level framework used for comp.
- Budgets: cycle budget types used to control spend.
- Currencies: multi-currency support for planning.
- Compensation admins: admins added to manage compensation features.
4) Lifecycle / state machine (cycle states)
Comp cycles often behave like a project lifecycle. Treat it as staged work so stakeholders know what to expect.
- Designed: cycle scope and budgets defined.
- Prepared: job architecture and bands set; currencies confirmed.
- Active: managers/owners make recommendations.
- Reviewed: HR/finance review for consistency and budget.
- Finalized: cycle decisions completed and communicated.
5) Core jobs-to-be-done
Use these jobs as your implementation plan for the first compensation cycle.
- Add job architectures for Deel Compensation.
- Set up compensation bands.
- Create and manage compensation cycles.
- Choose budget types for the cycle.
- Add currencies for global comp planning.
- Add admins to Compensation (control who manages cycles).
6) Happy path workflow #1 — Set up the foundation
Use this when you’re preparing for your first cycle and want the structure in place before inviting stakeholders.
- Define your job architecture (levels, roles, families) in your internal comp doc.
- Configure job architectures in Deel Compensation.
- Create compensation bands aligned to each level/role.
- Add currencies you plan to use for the cycle.
- Add Compensation admins (small set of owners).
- Run a spot-check: sample worker mapped to job/level and correct band.
7) Happy path workflow #2 — Run a compensation cycle
Use this when you want a repeatable process for comp decisions, rather than a spreadsheet scramble.
- Create a new compensation cycle and define scope (who’s included).
- Select the budget type(s) for the cycle.
- Confirm the job architecture and bands are ready.
- Invite stakeholders (managers/approvers) according to your internal process.
- Collect recommendations and review for consistency and budget.
- Finalize the cycle decisions.
- Document outcomes and lessons learned for the next cycle.
8) Decision points (A/B)
These decisions determine complexity and adoption speed.
| Decision | If A… | If B… |
|---|---|---|
| Job architecture depth | Simple → faster setup | Detailed → better precision, more work |
| Band strictness | Tight bands → consistency | Flexible bands → manager autonomy, drift risk |
| Budget approach | Strict budgets → control | Loose budgets → flexibility, overspend risk |
| Multi-currency | Single currency → simpler | Multi-currency → realistic, more complexity |
9) Common mistakes + guardrails
Most issues come from weak structure or too many admins. Keep it disciplined.
- Mistake: starting cycles before job architecture → Avoid: set architecture and bands first.
- Mistake: inconsistent leveling → Avoid: define leveling rules internally.
- Mistake: too many admins → Avoid: keep a small owner group.
- Mistake: unclear budgets → Avoid: align on budget types and constraints up front.
- Mistake: currency confusion → Avoid: document FX assumptions and currency usage.
10) What good looks like + checklists + practice lab + official docs
This section is your “comp readiness” checklist.
What good looks like
- Every role maps to a job architecture and band.
- Admins are limited and trained.
- Cycle budgets are clear and enforced.
- Cycle outcomes are documented and repeatable.
Checklist: Pre-check
- Job architecture defined
- Bands created
- Currencies confirmed
- Admins assigned
- Pilot scope chosen
Checklist: Post-check
- Cycle completed
- Budget respected
- Exceptions documented
- Lessons learned captured
- Next cycle date planned
Practice lab (5–15 min)
Goal: prepare a tiny “demo” foundation.
- Create a minimal job architecture (2 roles × 2 levels).
- Create one compensation band per level.
- Add one currency you use.
- Draft a mock cycle plan (scope + budget type).
Official docs links (titles)
- Adding job architectures for Deel Compensation
- Setting up compensation bands with Deel Compensation
- Creating and managing compensation cycles with Deel Compensation
- Types of budgets for Deel Compensation comp cycles
- How to add currencies to Compensation
- How to add admins to Deel Compensation
Talent Management
- Understand what Deel Talent covers (client vs partner context).
- Start with the overview and hiring flow basics.
- Decide who owns sourcing, screening, and selection.
- Keep process simple and auditable.
1) Purpose, who it’s for, and where to click
Talent Management in Deel HR references Deel Talent and hiring-related guidance (including an overview for clients and information for talent partners). The goal is to understand the offering, the hiring flow, and what inputs you need to be successful.
- Who it’s for: recruiters, hiring managers, HR teams exploring Deel Talent.
- When to use: when you plan to hire with Deel Talent or collaborate with talent partners.
- Where in navigation: Help Center → For business → Deel HR → Talent Management.
- Related tabs: Integrations & API (ATS integrations), People Management (new worker records), Reports.
- Outcome: a clear, minimal hiring workflow and ownership map.
2) Mental model (intake → sourcing → selection)
Keep your mental model simple: define the role clearly, decide how candidates are sourced, then run a consistent selection process. Complexity kills speed and quality for early adoption.
- Role intake: requirements, must-haves, timeline.
- Candidate sourcing: where candidates come from (Deel Talent/partners/other).
- Screening and interviews: consistent stages.
- Offer and handoff: move to onboarding/People.
3) Objects & terms
These terms come from the official Talent Management section list.
- Deel Talent (for Clients): client-facing overview context.
- Deel Talent (for Talent Partners): partner-facing overview context.
- Hiring with Deel Talent: practical hiring guidance entry point.
- FAQ pages: reference for edge cases and clarifications.
4) Lifecycle / state machine
The Talent lifecycle is a pipeline. Even if you don’t model every stage, agreeing on states prevents candidate loss and confusion.
- Intake: role defined and approved.
- Sourcing: candidates identified.
- Screening: initial qualification.
- Interviewing: structured evaluation stages.
- Decision: offer/no-offer and documentation.
- Handoff: move successful hire to onboarding/People processes.
5) Core jobs-to-be-done
Use these jobs to plan your first “real” role you hire through this path.
- Read the client overview and align stakeholders on scope.
- Define hiring intake template (requirements, budget, timeline).
- Run one hiring flow end-to-end.
- Decide whether to use ATS integrations vs manual tracking.
- Establish partner collaboration rules (if using partners).
- Define handoff steps from “hired” to People onboarding.
6) Happy path workflow #1 — Hire with Deel Talent (minimal)
Use this as a simple blueprint for one role so you can iterate quickly.
- Confirm the role requirements and hiring timeline.
- Review the Deel Talent client overview so stakeholders know what to expect.
- Decide sourcing method and ownership (HR vs manager vs partner).
- Set 2–4 pipeline stages (screen → interview → decision).
- Run candidate screening with consistent criteria.
- Make decision and document rationale.
- Handoff the hire to People onboarding steps.
7) Happy path workflow #2 — Partner collaboration setup
Use this if you expect to work with talent partners and want fewer misalignments.
- Read the talent partner overview to understand the partner model.
- Define what partners can do vs what HR/managers do internally.
- Agree on candidate submission format and timing.
- Agree on feedback SLAs (e.g., respond in 48 hours).
- Run a pilot with one partner and one role.
- Review what worked and tighten the process.
8) Decision points (A/B)
These decisions determine speed and consistency.
| Decision | If A… | If B… |
|---|---|---|
| ATS vs no ATS | ATS → better tracking | No ATS → faster start, less visibility |
| Stages count | Few stages → speed | Many stages → rigor, slower |
| Owner of screening | HR-owned → consistent | Manager-owned → contextual, variable |
| Partner usage | Use partners → sourcing boost | No partners → simpler operations |
9) Common mistakes + guardrails
Hiring breaks down when speed and ownership are unclear.
- Mistake: vague role intake → Avoid: define must-haves and timeline.
- Mistake: too many stages early → Avoid: keep pipeline lean.
- Mistake: slow feedback → Avoid: set response SLAs.
- Mistake: no handoff to onboarding → Avoid: define “hired → People” steps.
- Mistake: unclear partner boundaries → Avoid: document responsibilities.
10) What good looks like + checklists + practice lab + official docs
These help you keep hiring simple, measurable, and repeatable.
What good looks like
- Clear intake template used for every role.
- Pipeline stages are consistent.
- Feedback SLAs are met.
- Hires move cleanly into onboarding.
Checklist: Pre-check
- Role requirements written
- Owner assigned
- Stages defined
- Feedback SLA agreed
- Handoff plan defined
Checklist: Post-check
- Cycle time measured
- Decision notes captured
- Process updated
- Stakeholder feedback collected
- Next role queued
Practice lab (5–15 min)
Goal: design a 1-role hiring process that can run tomorrow.
- Write a one-page role intake (must-haves, timeline).
- Define 3 stages: screen → interview → decision.
- Assign owners for each stage.
- Define the handoff step into onboarding/People.
Official docs links (titles)
- Overview: Deel Talent - for Clients
- Hiring with Deel Talent
- Frequently Asked Questions About Deel Talent
- Overview: Deel Talent - for Talent Partners
Workforce Planning
- Workforce Planning is documented as “About Workforce Planning with Engage”.
- Start by defining planning scope and owners.
- Use People data and role structure as inputs.
- Run a small planning cadence before scaling.
1) Purpose, who it’s for, and where to click
Workforce Planning helps you plan headcount and workforce structure using the Engage-related planning capability referenced in the official docs navigation. The goal is to make staffing decisions repeatable and transparent.
- Who it’s for: HR/People Ops, finance partners, business leaders planning staffing.
- When to use: quarterly planning, org design reviews, headcount budgeting.
- Where in navigation: Help Center → For business → Deel HR → Workforce Planning.
- Related tabs: Engage, People Management, Compensation, Reports.
- Outcome: a documented planning cadence with clear inputs/outputs.
2) Mental model (inputs → scenarios → decisions)
Treat planning like a loop: gather inputs, build scenarios, choose a plan, and review outcomes. Start small—one department or one quarter.
- Inputs: current workforce data, open roles, budget constraints.
- Scenarios: hiring, backfill, re-org, or hiring freeze.
- Decision: approve plan and owners.
- Review: compare plan vs actual and iterate.
3) Objects & terms
The official section explicitly connects Workforce Planning with Engage, so align terminology across both.
- Workforce planning: deciding headcount and structure over time.
- Engage connection: planning is referenced as “with Engage”.
- Workforce data inputs: typically come from People directory/structure.
- Scenarios: alternative plans compared for decision-making.
4) Lifecycle / state machine
Planning is a recurring lifecycle rather than a one-time setup. Use these states to keep stakeholders aligned.
- Draft: inputs collected and assumptions written down.
- Proposed: scenarios and options prepared.
- Approved: leaders approve a plan and budget assumptions.
- Executed: recruiting/onboarding actions follow the plan.
- Reviewed: actuals compared against plan; adjustments made.
5) Core jobs-to-be-done
Use these jobs as your first implementation backlog.
- Define scope (which orgs/teams, which timeframe).
- Define owners (HR, finance, business lead).
- Collect baseline workforce inputs from People/structure.
- Create 2–3 scenarios and compare impacts.
- Turn the approved plan into hiring/onboarding actions.
- Review plan vs actual monthly and update.
6) Happy path workflow #1 — Run a mini quarterly plan
Use this when you’re adopting the feature and want a safe first win.
- Select one department and one quarter as your pilot scope.
- Gather current headcount and structure inputs from People.
- Define constraints (budget, critical roles, timelines).
- Create two scenarios: baseline vs growth (or baseline vs freeze).
- Review scenarios with stakeholders and pick one plan.
- Translate the plan into actions: roles to hire, backfills, timing.
- Set a monthly review checkpoint.
7) Happy path workflow #2 — Monthly plan-vs-actual review
Use this to keep planning honest and avoid “plan once, ignore forever”.
- Pull current headcount snapshot (from People and/or Reports).
- Compare actual vs planned headcount by team.
- Identify deltas: open roles, attrition, delayed start dates.
- Decide adjustments: accelerate, pause, or shift priorities.
- Update the plan assumptions and document decisions.
- Communicate changes to recruiters and managers.
8) Decision points (A/B)
These choices determine adoption speed and accuracy.
| Decision | If A… | If B… |
|---|---|---|
| Scope size | Small → fast learning | Large → big impact, more risk |
| Scenario count | 2 scenarios → clarity | Many → analysis paralysis |
| Review cadence | Monthly → accurate | Quarterly → less overhead, more drift |
| Inputs source | People data → consistent | Spreadsheets → flexible, mismatch risk |
9) Common mistakes + guardrails
Planning fails when assumptions are hidden and no one owns follow-through.
- Mistake: unclear scope → Avoid: define team and timeframe precisely.
- Mistake: no single owner → Avoid: name an accountable lead.
- Mistake: too many scenarios → Avoid: keep to 2–3.
- Mistake: no plan-vs-actual review → Avoid: monthly checkpoint.
- Mistake: People data not maintained → Avoid: assign a People data owner.
10) What good looks like + checklists + practice lab + official docs
Keep planning lightweight and repeatable.
What good looks like
- Scope and owners are explicit.
- Plan turns into concrete actions.
- Review cadence is followed.
- Assumptions are documented.
Checklist: Pre-check
- Pilot scope selected
- Inputs gathered
- Constraints defined
- Scenarios prepared
- Review meeting scheduled
Checklist: Post-check
- Plan approved
- Actions assigned
- Hiring timeline set
- Monthly review set
- Decision log created
Practice lab (5–15 min)
Goal: create a one-team plan in a simple doc.
- Write current headcount for one team.
- Write target headcount for next quarter.
- List 3 assumptions (budget, timeline, priority roles).
- Create 2 scenarios and pick one.
Official docs links (titles)
- About Workforce Planning with Engage
Reports (Analytics 2.0)
- Use Analytics 2.0 for dashboards and saved reports.
- Start with one dashboard for HR ops visibility.
- Create, save, and share reports safely.
- Know what report types exist (and what to export).
1) Purpose, who it’s for, and where to click
Reports help you turn Deel activity into visibility: dashboards for monitoring and reports for deeper analysis. The goal is to answer operational questions quickly (headcount, payroll summaries, process throughput) without manual spreadsheets.
- Who it’s for: HR admins, finance partners, ops leaders, analysts.
- When to use: weekly ops reviews, monthly reporting, audits, leadership updates.
- Where in navigation: Help Center → For business → Reports.
- Related tabs: People Management, Time Off, Compensation, Integrations & API (exports/connectors).
- Outcome: a saved dashboard + a saved report that stakeholders can reuse.
2) Mental model (dashboard vs report)
Dashboards are for ongoing monitoring; reports are for answering a specific question and sharing/exporting. Start with one dashboard, then add a report per recurring question.
- Pick a recurring question (e.g., “What’s our workforce status?”).
- Create a dashboard view for quick monitoring.
- Create a detailed report for drill-down.
- Save and share with controlled access.
3) Objects & terms
These terms map directly to the Reports articles.
- Analytics 2.0: reporting capability referenced in docs.
- Dashboard: saved monitoring view.
- Report: saved query/view that can be shared.
- Custom report: report you design and share.
- Total Payroll Summary Report: a specific downloadable summary.
4) Lifecycle / state machine (report governance)
Reports tend to proliferate. Use a lightweight lifecycle so reporting stays trustworthy.
- Draft: report/dashboard created for a question.
- Validated: numbers checked against a known source.
- Published: saved with a clear name and owner.
- Shared: access granted to the right stakeholders.
- Maintained: reviewed when definitions/data sources change.
- Archived: old reports retired to avoid confusion.
5) Core jobs-to-be-done
These align with the official reporting articles and what most teams need early.
- Understand Analytics 2.0 basics.
- Create and save dashboards.
- Create and save reports.
- Decide what kinds of reports you need.
- Create and share a custom report.
- View and download a Total Payroll Summary Report.
6) Happy path workflow #1 — Build a first dashboard
Use this when you want a single place to monitor key HR/ops signals weekly.
- Open Analytics 2.0 and decide the dashboard purpose (ops, payroll, people).
- Pick 3–5 metrics that answer your weekly questions.
- Create the dashboard and arrange components for quick scanning.
- Save the dashboard with a clear name and owner.
- Share with the smallest necessary audience.
- Review in your weekly meeting and refine.
7) Happy path workflow #2 — Create and share a custom report
Use this when you have a recurring question that needs a consistent answer and a shareable view.
- Write down the question the report must answer.
- Create the report in Analytics 2.0 aligned to that question.
- Validate results by spot-checking a few records.
- Save the report using a naming convention (Team — Purpose — Frequency).
- Share the report with specific stakeholders.
- Set a reminder to review the report monthly for relevance.
8) Decision points (A/B)
These choices affect trust and maintenance effort.
| Decision | If A… | If B… |
|---|---|---|
| Dashboard vs report | Dashboard → monitoring | Report → deep analysis |
| Share broadly vs narrowly | Broad → transparency, risk | Narrow → safer, more requests |
| One master report vs many | Master → one truth, complex | Many → flexible, sprawl risk |
| Validation rigor | High → trusted, more time | Low → fast, accuracy risk |
9) Common mistakes + guardrails
Reporting pain usually comes from unclear definitions and report sprawl.
- Mistake: unclear metric definitions → Avoid: define terms in the report description.
- Mistake: too many similar dashboards → Avoid: assign owners and archive duplicates.
- Mistake: sharing sensitive data widely → Avoid: least-privilege sharing and role checks.
- Mistake: no validation → Avoid: spot-check before publishing.
- Mistake: forgetting payroll summary needs → Avoid: standardize how you download and store summaries.
10) What good looks like + checklists + practice lab + official docs
Use this as your reporting maturity checklist.
What good looks like
- One weekly ops dashboard exists and is used.
- Top recurring questions have saved reports.
- Reports have owners and are maintained.
- Sharing respects roles and privacy.
Checklist: Pre-check
- Define the question
- Choose dashboard vs report
- Pick metrics
- Plan validation
- Set naming convention
Checklist: Post-check
- Saved and named clearly
- Spot-checked accuracy
- Shared with correct audience
- Owner assigned
- Review cadence scheduled
Practice lab (5–15 min)
Goal: create one dashboard or report for a recurring question.
- Pick one question you answer every week.
- Create a dashboard or report that answers it.
- Save it with a clear name.
- Share it with one stakeholder and ask them to self-serve next time.
Official docs links (titles)
- Analytics 2.0 Overview in Deel
- How to Create and Save Dashboards in Deel Analytics 2.0
- How to Create and Save Reports in Deel Analytics 2.0
- What Kinds Of Reports Can Be Generated On Deel?
- How to Create and Share a Custom Report
- How To View And Download A Total Payroll Summary Report
Integrations & API
- Know the integration categories (HRIS, ATS, SSO, SCIM, SFTP, API, etc.).
- Start with identity (SSO/SCIM) only when roles are stable.
- Connect HRIS/ATS only after People data is clean.
- Document data ownership and sync rules.
1) Purpose, who it’s for, and where to click
Integrations & API helps you connect Deel with the rest of your stack (HRIS, ATS, accounting, identity, file transfer, and API). The goal is fewer manual updates and a clean system-of-record strategy.
- Who it’s for: HRIS owners, IT admins, operations, developers (API).
- When to use: after your People data and roles are stable enough to automate safely.
- Where in navigation: Help Center → For business → Integrations & API.
- Related tabs: People Management, Roles & Permissions, Reports.
- Outcome: one integration live with documented sync rules and owners.
2) Mental model (systems + sync rules)
Every integration needs a “source of truth” decision. Decide where each field is mastered, then define the sync direction and cadence.
- Pick your master system for worker core data.
- Decide what Deel should push vs pull.
- Define who owns failures and reconciliation.
- Roll out to a pilot group before full org.
3) Objects & terms (integration categories)
These categories are explicitly listed under Integrations & API in the official navigation.
- HRIS Integrations
- Applicant Tracking System (ATS) Integrations
- SSO Integrations
- SCIM Integrations
- SFTP Integrations
- User Management Integrations
- Accounting Integrations
- Deel API
4) Lifecycle / state machine (integration rollout)
Treat integrations like a product rollout to avoid “silent data drift”.
- Planned: use-case, owners, and source-of-truth defined.
- Configured: connection created and permissions set.
- Piloted: small set of users/records validated.
- Monitored: failures and drift tracked.
- Scaled: expanded to full organization.
- Maintained: periodic reconciliation and changes managed.
5) Core jobs-to-be-done
Use these jobs as your integration implementation plan.
- Choose an integration category (HRIS, ATS, SSO, etc.).
- Define what data should sync and in what direction.
- Set up identity (SSO/SCIM) for access scaling (if applicable).
- Connect ATS if hiring pipeline needs syncing.
- Use SFTP for file-based workflows if required.
- Use Deel API for custom needs.
6) Happy path workflow #1 — Connect an HRIS integration (pilot)
Use this when you want worker data to be consistent across systems.
- Select the HRIS integration path from Integrations & API.
- Define source-of-truth for worker fields (name, email, manager, etc.).
- Confirm Roles & Permissions so the right admins can configure the integration.
- Pilot with a small worker group.
- Validate: workers match in both systems, and manager relationships are correct.
- Document the sync rules and what to do when mismatches happen.
- Scale to the rest of the org.
7) Happy path workflow #2 — Roll out SSO/SCIM safely
Use this when you’re ready to scale access management and want fewer manual invites and removals.
- Confirm your internal identity owner (IT) and access policies.
- Validate roles model in Deel (Org Admin/Group Admin/Manager) is stable.
- Choose SSO integration for authentication setup.
- Choose SCIM integration for provisioning (if you plan to automate user lifecycle).
- Pilot with a small admin group and verify login + permissions.
- Test offboarding: access removed when user is deprovisioned.
- Scale gradually and monitor for access issues.
8) Decision points (A/B)
These decisions define your integration architecture.
| Decision | If A… | If B… |
|---|---|---|
| API vs native integration | Native → faster setup | API → flexible, needs dev work |
| SSO timing | Early → consistent auth | Later → less risk, more manual work |
| SCIM provisioning | Use SCIM → automated lifecycle | No SCIM → manual user management |
| Sync direction | One-way → simpler | Two-way → complex, conflict risk |
9) Common mistakes + guardrails
Integration mistakes are expensive because they create silent data drift.
- Mistake: integrating before data cleanup → Avoid: fix duplicates and structure first.
- Mistake: unclear source of truth → Avoid: define field ownership in writing.
- Mistake: broad admin access for setup → Avoid: least privilege and time-boxed access.
- Mistake: skipping pilot → Avoid: pilot a small group.
- Mistake: no failure ownership → Avoid: define who monitors and fixes sync issues.
10) What good looks like + checklists + practice lab + official docs
These keep your integrations safe and maintainable.
What good looks like
- One integration works reliably for a pilot group.
- Source-of-truth rules are documented.
- Access and offboarding are tested.
- Monitoring and ownership are clear.
Checklist: Pre-check
- People data cleaned
- Roles model stable
- Owners assigned
- Sync rules written
- Pilot group selected
Checklist: Post-check
- Pilot validated
- Failure handling defined
- Docs updated
- Scale plan created
- Reconciliation cadence set
Practice lab (5–15 min)
Goal: define your integration contract (before connecting anything).
- Pick one integration category (HRIS or SSO).
- Write 5 fields and declare source-of-truth for each.
- Write the sync direction and cadence.
- Write who owns failures and where they’re tracked.
Official docs links (navigation categories)
- HRIS Integrations
- Applicant Tracking System (ATS) Integrations
- SSO Integrations
- SCIM Integrations
- SFTP Integrations
- User Management Integrations
- Accounting Integrations
- Deel API