# Welcome > Build powerful integrations with Deel's global workforce platform APIs Welcome to # Deel Developer Documentation REST, webhooks, MCP, and a CLI 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 · CLI** curl TypeScript Python Go Java MCP CLI \# 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 \# Create an invoice adjustment from the terminal deel adjustments create --invoice --env demo --input type=BONUS,amount=500,contract_id=C123,description="Q3 bonus",date_submitted=2026-09-01 --- "data": "adjustment_id": "adj_4Kp9...", "status": "pending", "is_created": true , "meta": "request_id": "8b1c1a2e-..." # Agents discover any command before calling it deel adjustments create --invoice --help --json ● 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 [![](/_fern-img/3eecda7bb100cce2e8549060a9283c34741d81c736b03473ff053541d1afa1de.webp)](/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 [![](/_fern-img/49e484a7ed73bc300e1c54c604fdd76ea8f9b6f494cf2788696eb6e3b322acaa.webp)](/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 [![](/_fern-img/b86eb45cfa2ce79b7babecdb98c0c8feeef53926cf21673004441de694e8123c.webp)](/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 [![](/_fern-img/14a7548e011468158107e34e41e28c84be6d4655b747edea57245767daf9d021.webp)](/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 [![](/_fern-img/649768035e409820055f1d887de0784ccc0ac0854ce005c6601c27ed58440459.webp)](/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 [![](/_fern-img/c7ba3896d446bcba0d4aaeca86293d2304d10c3d8c5759a950a2256c91632d6c.webp)](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 [![](/_fern-img/c61c8c74c7dc1dfaacec5b09a49108c31987fb1cdf26f5b4869ed1d4e50e1758.webp)](/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 [![](/_fern-img/2296189e7e2d7ee3b770dba6cada4aa20df6c96f99929c83b7755293c80452b8.webp)](/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 [![](/_fern-img/8b6324e28d01a522df9526a162a2a49d2d7f76f694203a44679c7fe2eb6232fa.webp)](/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) - [CLI](https://developer.deel.com/cli/llms.txt): Deel operations for AI agents, coding assistants, and your terminal - [Introduction](https://developer.deel.com/cli/introduction.md) - [Installation](https://developer.deel.com/cli/installation.md) - [Quickstart](https://developer.deel.com/cli/quickstart.md) - [Authentication](https://developer.deel.com/cli/authentication.md) - [Overview](https://developer.deel.com/cli/agents/overview.md)