> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.
# Welcome
> Build powerful integrations with Deel's global workforce platform APIs
Welcome to
# Deel Developer Documentation
REST, webhooks, and MCP for hiring, payroll, HR, and compliance.
Ship apps, automations, and embedded experiences on the workforce platform
40,000+ companies run their global teams on.
[bolt Quickstart](/api/quickstart)
[menu\_book API reference](/api/reference)
**REST · OpenAPI 3.0.1** **MCP · Webhooks**
curl
TypeScript
Python
Go
Java
MCP
\# Create a contractor contractPOST [https://api.letsdeel.com/rest/contracts](https://api.letsdeel.com/rest/contracts)Authorization: Bearer \$DEEL\_API\_KEYContent-Type: application/json "data": "title": "Senior Backend Engineer", "type": "ongoing\_time\_based", "country\_code": "GB", "start\_date": "2026-02-01", "worker": "first\_name": "Alex", "last\_name": "Rivera", "expected\_email": "[alex.r@acme.dev](mailto:alex.r@acme.dev)" , "compensation\_details": "amount": 8000, "currency\_code": "GBP", "frequency": "monthly"
---
201 Created · 138ms "data": "id": "ctr\_7HqK2mJ...", "status": "draft", "type": "ongoing\_time\_based", "country\_code": "GB"
// Create a contractor contractconst response = await fetch("[https://api.letsdeel.com/rest/contracts](https://api.letsdeel.com/rest/contracts)", method: "POST", headers: "Authorization": "Bearer " + process.env.DEEL\_API\_KEY, "Content-Type": "application/json", , body: JSON.stringify( data: title: "Senior Backend Engineer", type: "ongoing\_time\_based", country\_code: "GB", start\_date: "2026-02-01", worker: first\_name: "Alex", last\_name: "Rivera", expected\_email: "[alex.r@acme.dev](mailto:alex.r@acme.dev)", , compensation\_details: amount: 8000, currency\_code: "GBP", frequency: "monthly", , , ),);const contract = await response.json();console.log(contract.data.id);→ ctr\_7HqK2mJ...
\# Create a contractor contractimport osimport requestsresponse = requests.post( "[https://api.letsdeel.com/rest/contracts](https://api.letsdeel.com/rest/contracts)", headers= "Authorization": "Bearer " + os.environ\["DEEL\_API\_KEY"], "Content-Type": "application/json", , json= "data": "title": "Senior Backend Engineer", "type": "ongoing\_time\_based", "country\_code": "GB", "start\_date": "2026-02-01", "worker": "first\_name": "Alex", "last\_name": "Rivera", "expected\_email": "[alex.r@acme.dev](mailto:alex.r@acme.dev)", , "compensation\_details": "amount": 8000, "currency\_code": "GBP", "frequency": "monthly", , , , )contract = response.json()print(contract\["data"]\["id"])# → ctr\_7HqK2mJ...
// Create a contractor contractpayload, \_ := json.Marshal(map\[string]any "data": map\[string]any "title": "Senior Backend Engineer", "type": "ongoing\_time\_based", "country\_code": "GB", "start\_date": "2026-02-01", "worker": map\[string]any "first\_name": "Alex", "last\_name": "Rivera", "expected\_email": "[alex.r@acme.dev](mailto:alex.r@acme.dev)", , "compensation\_details": map\[string]any "amount": 8000, "currency\_code": "GBP", "frequency": "monthly", , ,);req, \_ := http.NewRequest("POST", "[https://api.letsdeel.com/rest/contracts](https://api.letsdeel.com/rest/contracts)", bytes.NewReader(payload))req.Header.Set("Authorization", "Bearer "+os.Getenv("DEEL\_API\_KEY"))req.Header.Set("Content-Type", "application/json")resp, \_ := http.DefaultClient.Do(req)// → 201 Created
// Create a contractor contractvar json = """ "data": "title": "Senior Backend Engineer", "type": "ongoing\_time\_based", "country\_code": "GB", "start\_date": "2026-02-01", "worker": "first\_name": "Alex", "last\_name": "Rivera", "expected\_email": "[alex.r@acme.dev](mailto:alex.r@acme.dev)" , "compensation\_details": "amount": 8000, "currency\_code": "GBP", "frequency": "monthly" """;var request = HttpRequest.newBuilder() .uri(URI.create("[https://api.letsdeel.com/rest/contracts](https://api.letsdeel.com/rest/contracts)")) .header("Authorization", "Bearer " + System.getenv("DEEL\_API\_KEY")) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(json)) .build();HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString());// → 201 Created
\# Connect Claude Desktop to Deel's MCP server# \~/Library/Application Support/Claude/claude\_desktop\_config.json "mcpServers": "deel": "url": "[https://api.letsdeel.com/mcp](https://api.letsdeel.com/mcp)"
---
Claude now has access to tools like:• org\_person\_list• contract\_list• timeoff\_request\_create• eor\_employment\_cost\_calculate
● 201 Created
138 ms
## Launch and integrate apps
[smart\_toy MCP Server](/mcp)
## Connect AI agents to workforce data
Expose contracts, people, payroll, and time data to Claude, ChatGPT, or your own agent with Deel's MCP server. OAuth, scoped access, and tool discovery out of the box.
Connect Deel to your AI agent north\_east
[extension App Store](/api/partners/introduction)
## Build an integration for the Deel App Store
Get your integration in front of 40,000+ Deel customers. OAuth install flow, managed listings and review, and the Partner API — everything you need to drive adoption from day one.
Build & publish your Deel app north\_east
[public Deel Embedded](/api/embedded/eor-overview)
## Global employment infrastructure, via API
Build global employment natively into your product — your team owns the UX, Deel stays invisible. Built on owned infrastructure across 130+ entities in 150+ countries. 50M API calls per month at 99.95% reliability.
Build with Embedded north\_east
## One platform for every integration
Deel Payroll expand\_more
Globally standardized payroll with local execution. Designed for multi-entity complexity and audit readiness without disrupting local in-country processes.
Deel Hire expand\_more
Execute hiring and acquisitions immediately. Use EOR and Contractor models to launch teams in days, not months, while Deel owns the legal and compliance risk.
Deel Mobility expand\_more
Manage relocations and cross-border moves with structured processes and expert support, without operational disruption.
Deel IT expand\_more
Provision, ship, secure, and manage devices globally with policy-based controls that fit enterprise workflows.
## What will you build on Deel today?
### Hire and pay global employees
[](/api/employer-of-record)
#### Enable global hiring workflows
Turn a job offer into a fully onboarded employee in 150+ countries, with contracts, compliance, and payroll included.
Build a global hiring flow arrow\_forward
[](/api/global-payroll)
#### Automate payroll operations
Push raises, bonuses, deductions, and expense reimbursements into payroll automatically. No spreadsheets, no missed deadlines.
Build a payroll inputs flow arrow\_forward
[](/api/global-payroll/time-tracking)
#### Sync workforce cost and payroll data
Stream salary, tax, and employer cost data from Deel into your BI stack, giving finance teams visibility into global headcount spend by country, entity, or worker type.
Build a workforce cost feed arrow\_forward
### Pay and manage contractors
[](/api/contractors)
#### Automate contractor onboarding
Generate a compliant contract, collect a signature, and capture KYC and bank details before the worker logs their first hour.
Build contractor onboarding arrow\_forward
[](/api/contractors/timesheets)
#### Process contractor payments
Submit hours and receipts from your own product, route approvals, and push them straight through to the next payout.
Build a time & expense flow arrow\_forward
[](api/common-use-cases/reimburse-contractor-expenses)
#### Trigger real-time payments
Trigger off-cycle payments, milestone payouts, and bonuses in 120+ currencies. No payroll cycle required.
Build a payments flow arrow\_forward
### Wire Deel into your stack
[](/api/hris)
#### Sync workforce systems and identity
Two-way sync with your IdP or HRIS so a new hire shows up everywhere they need to, and a leaver disappears just as cleanly.
Sync people across systems arrow\_forward
[](/api/platform/screenings)
#### Automate compliance workflows
Run background checks, right-to-work, screenings, and immigration cases through one API, and prove it to auditors later.
Automate compliance arrow\_forward
[](/api/webhooks/introduction)
#### Trigger event driven automations
Subscribe to contracts, payments, timesheets, and approvals. Trigger Slack alerts, Jira tickets, or your own logic the moment they change.
Build event-driven flows arrow\_forward
## Need anything else? We’re here.
[forum](https://stack.deel.com/)
#### Join the community
Chat with other developers building on Deel in Deel Stack.
[schedule](/api/changelog)
#### Changelog
Every API change, shipped on the date it went live.
[key](https://help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API)
#### How to get API keys
Step-by-step Help Center article. Keys are issued from the Deel app.
### Trusted by 40,000+ companies, from startups to enterprise
