Deel

Let your agents read people, contracts, time off, invoices, timesheets, teams and legal entities in Deel, file time-off requests and log contractor hours for review.

Connection

Authentication: API key (Organization API token).
Required settings:
- Environment — api in production, api-staging for the API sandbox.

In Deel: More → Developer → Access Tokens → Generate new token → choose “Organization token”, then select the scopes: people:read, contracts:read, time-off:read, accounting:read, organizations:read and timesheets:read — plus time-off:write and worker:write to file time-off requests, and timesheets:write to log hours. Generate, then copy the token right away (it is shown only once). For a sandbox token, create it from the API Sandbox tab of the Developer Center and set the environment to api-staging.See Deel’s documentation.

Read actions (12)

Action	Description
`get_contract`	Retrieve the full record of one contract (id from list_contracts), optionally expanded with cost_centers and/or custom_fields.
`get_person`	Retrieve one person by hris_profile_id (UUID from list_people): personal and employment details, team, manager, status.
`list_contracts`	List contract summaries, cursor-paginated (after_cursor), with optional filters on type, status, team, legal entity, country, currency, external id or a name search.
`list_countries`	List the countries supported by Deel (code, name, EOR availability, visa support, sub-territories).
`list_currencies`	List the currencies supported by Deel (ISO code and name).
`list_invoices`	List invoices (only paid ones by default; status “all” returns every status), with optional issue-date range, offset or cursor pagination.
`list_legal_entities`	List the organization’s legal entities, cursor-paginated, with optional country, entity type, global payroll and archived filters.
`list_people`	List people (workers) of the organization, paginated by offset/limit, with optional name search, team, hiring status/type and person status filters. Each person’s id is the hris_profile_id used by get_person and time-off actions.
`list_person_time_off_policies`	List the time-off policies assigned to one person (hris_profile_id from list_people), with their balances and allowed time-off types: gives the policy_id and time_off_type_id that create_time_off_request needs.
`list_teams`	List the teams of the organization (id and name).
`list_time_off_requests`	List time-off requests of the whole organization, cursor-paginated (next), with optional status and date-range filters (ISO 8601 date-times).
`list_timesheets`	List timesheet entries, offset-paginated, optionally filtered by contract, contract types, statuses, reporter or submission date range (YYYY-MM-DD, date_to exclusive).

Write actions (2)

Action	Description
`create_time_off_request`	File a time-off request for a worker. Arguments: recipient_profile_id (string UUID, the hris_profile_id from list_people, required); start_date and end_date (strings “YYYY-MM-DD” or ISO 8601 date-time, required); policy_id OR time_off_type_id (string UUID from list_person_time_off_policies, one of the two required); contract_oid (string contract id, optional, for a worker with several contracts); description, reason and other_type_description (plain strings, optional; some policies require a description). The request is always created with status REQUESTED: approval stays human. Sent as {“data”: {…}}.
`create_timesheet`	Log hours worked on an hourly contractor contract; the entry goes into Deel’s review workflow (never auto-approved). Arguments: contract_id (string, contract id from list_contracts, required); quantity (number of work units, typically hours, at least 0.01, required); description (plain string shown on the invoice, required); date_submitted (string “YYYY-MM-DD”, day the work was done, required). Sent as {“data”: {…}}.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (12)

Write actions (2)

Permissions

​Connection

​Read actions (12)

​Write actions (2)

​Permissions

Connection

Read actions (12)

Write actions (2)

Permissions