Deel – Gotchas
Deel is the first payroll platform for remote teams that connects localized compliance and payments in one system of record and automates everything.
2 gotchas across 1 resource
These are connector-specific behaviors and limitations to be aware of when integrating.
Employees2 gotchas
employeesAllThe emails[].type value primary follows the worker's own Deel account (login) email, which may be
either their work or their personal address and therefore varies from worker to worker. Deel does not
document how the flag is chosen, so treat this as observed behaviour.
To avoid depending on which address happens to be primary, the primary address is also returned a second
time under its real type. A worker whose account email is their work address returns both
{"type": "primary"} and {"type": "work"} for it, so reading the work entry gives the work address
regardless of the primary flag. Because Deel can list the same address more than once, one address may
appear in several entries with different types.
Deel home addresses are returned as personal.
Use ?raw=true to see Deel's original type and primary flags.
employeesOneThe emails[].type value primary follows the worker's own Deel account (login) email, which may be
either their work or their personal address and therefore varies from worker to worker. Deel does not
document how the flag is chosen, so treat this as observed behaviour.
To avoid depending on which address happens to be primary, the primary address is also returned a second
time under its real type. A worker whose account email is their work address returns both
{"type": "primary"} and {"type": "work"} for it, so reading the work entry gives the work address
regardless of the primary flag. Because Deel can list the same address more than once, one address may
appear in several entries with different types.
Deel home addresses are returned as personal.
Use ?raw=true to see Deel's original type and primary flags.