Overview
Deel is a global HR and payroll platform – contractors, EOR (employer-of-record) hires across 150+ countries, payroll, contracts, compliance. The Automize Deel connector covers people, contracts, invoices, payments, and time off.
- Regions: Deel is global – api.letsdeel.com. Country-specific payroll/EOR handled internally by Deel.
- Plans: Pricing per contractor / per employee per month. API access available on Business + Premium plans.
Setting up the connection
Auth type: Bearer Token.
- Sign in to Deel → Settings → Integrations → API key → Generate.
- Pick scope (read-only or read-write across modules).
- Copy the token.
- In Automize, open Settings → Connectors → Deel → Add connection. Paste the token.
Find your credentials at https://app.deel.com/api-keys.
Rate limits
Deel enforces ~120 req/min/token. Connector retries 429 with backoff.
Data model
Workforce-centric:
Person (worker – contractor, EOR employee, or direct employee) ─┬─ Contract
├─ Invoices
├─ Payments
└─ Time Off
Contracts have lifecycle states: ongoing, paused, terminated.Available operations
9 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Contract | General | Create a new contract |
| Create Time Off | General | Submit a time off request |
| Get Contract | General | Get contract details |
| Get Person | General | Get person details |
| List Contracts | General | List all contracts |
| List Invoices | General | List all invoices |
| List Payments | General | List all payments |
| List People | General | List all people |
| List Time Off | General | List time off requests |
Operations
Create Contract
Create a new contract
| Parameter | Required | Type | Description |
|---|---|---|---|
Data data | Yes | textarea |
Tips
- data: payload varies by contract type. Most contracts require manager approval before being active.
- Use the Deel app for first-time contract creation – API is for automation of repeatable patterns.
Create Time Off
Submit a time off request
| Parameter | Required | Type | Description |
|---|---|---|---|
Data data | Yes | textarea |
Tips
- data: person + type + start_date + end_date + reason. Routes through Deel's approval flow.
Get Contract
Get contract details
| Parameter | Required | Type | Description |
|---|---|---|---|
Contract Id contract_id | Yes | text |
Tips
- Returns contract + terms + compensation.
Get Person
Get person details
| Parameter | Required | Type | Description |
|---|---|---|---|
Person Id person_id | Yes | text |
Tips
- person_id. Returns full profile.
List Contracts
List all contracts
No input parameters.
Tips
- Filter by status (ongoing, paused, terminated), country, type (contractor, eor_employee, direct_employee).
List Invoices
List all invoices
No input parameters.
Tips
- Invoices submitted by contractors. Filter by status (pending, approved, paid).
List Payments
List all payments
No input parameters.
Tips
- Payments made TO workers via Deel. Filter by date range, currency, status.
List People
List all people
No input parameters.
Tips
- Returns all workers (contractors + EOR + employees). Filter via query params.
- Page via limit + offset.
List Time Off
List time off requests
No input parameters.
Tips
- Time off requests. Filter by status, person_id, date range.
FAQ
- Contractor vs EOR vs direct employee – what's the difference?
- Contractor = independent contractor, Deel handles invoicing only. EOR (Employer of Record) = Deel legally employs the worker on your behalf in their country. Direct employee = your own entity employs them. Each contract type has different fields and processes.
- Why is Create Contract returning 'requires approval'?
- Most contract creation flows go through Deel's KYC + legal review. The API creates the proposal; final activation needs human approval in Deel app. Use the UI for first-time setup.
- Bulk operations?
- Most endpoints accept arrays for batch reads. Bulk writes (e.g. mass-update contracts) are limited – Deel prefers operations through their UI for compliance.