# 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](https://website-media.deel.com/asset_continuous_compliance_d8585356b5.webp)![Deel Hire](https://website-media.deel.com/asset_deel_ai_static_2x_e19d55f446.webp)![Deel Mobility](https://website-media.deel.com/asset_reports_analytics_static_2x_c926120c0f.webp)![Deel IT](https://website-media.deel.com/asset_integrations_and_api_640w_71383c79f5.webp) 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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/3eecda7bb100cce2e8549060a9283c34741d81c736b03473ff053541d1afa1de/docs/assets/hire-anyone.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=6dbb870c2535866ccf861cda35419656fa586b9995d0c2e39411b197132dc523&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/49e484a7ed73bc300e1c54c604fdd76ea8f9b6f494cf2788696eb6e3b322acaa/docs/assets/run-payroll.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=c9c9f8263c0404e082f3cccaa9523a45a379e51d004816c5d5ebfbee6dd79aaf&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/b86eb45cfa2ce79b7babecdb98c0c8feeef53926cf21673004441de694e8123c/docs/assets/see-workforce-costs.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=0cf82b4f161b406573a749e22da3a5edd92d4d119f15fef75674fa93dfdb3b3e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/14a7548e011468158107e34e41e28c84be6d4655b747edea57245767daf9d021/docs/assets/sign-a-contractor.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=d31b19680285f99f289841c94161077766abd846e6d1581846cb0839afbdcc54&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/649768035e409820055f1d887de0784ccc0ac0854ce005c6601c27ed58440459/docs/assets/turn-time-and-expenses.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=6c045f307b4705fb13dcc4c8226a7e935070d21aa5c002bfd91df1a5473a64b9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/c7ba3896d446bcba0d4aaeca86293d2304d10c3d8c5759a950a2256c91632d6c/docs/assets/reward-great-work.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=a468b07576396b491108372a0e0f085148f63d010d1bdf057cafb2bde87a0d5c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/c61c8c74c7dc1dfaacec5b09a49108c31987fb1cdf26f5b4869ed1d4e50e1758/docs/assets/make-deel-feel.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=fb9c6f111f8a8aca4316f9f7eb237165b8d61b41d50eded6680ebbf13b7abba4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/2296189e7e2d7ee3b770dba6cada4aa20df6c96f99929c83b7755293c80452b8/docs/assets/hire-compliant-by.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=a23522a834fed1af09c836e2d50c97026deb3507764b41942cbb154fd3a648cf&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 [![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/deel-prod.docs.buildwithfern.com/8b6324e28d01a522df9526a162a2a49d2d7f76f694203a44679c7fe2eb6232fa/docs/assets/build-workflows-that.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T083546Z&X-Amz-Expires=604800&X-Amz-Signature=f485f8dbd350abddfccc9e947f72d9ff2ef2e4db4bba19a953e7d60fa1803e41&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)](/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 ![Shopify](https://website-media.deel.com/logo_scroller_shopify_31f4749d8c.svg)![Klarna](https://website-media.deel.com/logo_scroller_klarna_e34cc41c5c.svg)![Reddit](https://website-media.deel.com/reddit_93629e804a.svg)![Jelly Belly](https://website-media.deel.com/logo_scroller_jellybelly_425a624ffc.svg)![Instacart](https://website-media.deel.com/logo_scroller_instacart_cfbc68d690.svg)![On Running](https://website-media.deel.com/logo_scroller_on_running_cff30fcd5e.svg)![](https://website-media.deel.com/logo_scroller_shopify_31f4749d8c.svg)![](https://website-media.deel.com/logo_scroller_klarna_e34cc41c5c.svg)![](https://website-media.deel.com/reddit_93629e804a.svg)![](https://website-media.deel.com/logo_scroller_jellybelly_425a624ffc.svg)![](https://website-media.deel.com/logo_scroller_instacart_cfbc68d690.svg)![](https://website-media.deel.com/logo_scroller_on_running_cff30fcd5e.svg) > Build apps and integrations that extend and enhance the Deel services. ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server ## Products - [API](https://developer.deel.com/api/llms.txt): Build your own integrations with the Deel API - [Quickstart](https://developer.deel.com/api/stable/quickstart.md) - [Sandbox](https://developer.deel.com/api/stable/sandbox.md) - [Authentication](https://developer.deel.com/api/stable/authentication.md) - [API versioning](https://developer.deel.com/api/stable/api-versioning.md) - [OAuth 2.0](https://developer.deel.com/api/stable/oauth.md) - [MCP Server](https://developer.deel.com/mcp/llms.txt): Build AI agents to interact with the Deel - [Introduction](https://developer.deel.com/mcp/introduction.md) - [Authorization](https://developer.deel.com/mcp/authorization.md) - [Connecting clients](https://developer.deel.com/mcp/connecting-clients.md) - [Tools reference](https://developer.deel.com/mcp/reference/tools-reference.md) - [Error handling](https://developer.deel.com/mcp/reference/error-handling.md)