How do you authenticate to the Deel API?
Per Deel's developer documentation, all requests use HTTPS and a Bearer token, or OAuth2.
| Token | Represents | Used for, per Deel |
|---|---|---|
| Organization token | The whole organization | Server-to-server: contracts, payroll, invoices, SCIM |
| Personal token | One user | Contract creation, SSO integrations, user-scoped actions |
| Worker token | One EOR worker | Embedded flows where the worker acts on their own data |
From the Authentication page of Deel's developer documentation, November 21, 2026. Tokens come from More, then Developer, in the Deel dashboard.
How do you test before touching real data?
Deel's quickstart has you create a separate sandbox in the Developer Center, with its own credentials.
- Sandbox base URL: https://api-staging.letsdeel.com/rest
- Production base URL: https://api.letsdeel.com/rest, with separate credentials
- Warning from Deel: production calls affect real data and can trigger real business processes, so test in the sandbox first.
From Deel's quickstart, November 21, 2026.
What are the rate limits?
Deel limits each organization to 5 requests per second across all its tokens, and returns a 429 error when you exceed it.
Plan for this in any sync: queue calls, back off on 429 and prefer webhooks over polling.
- Shared: every token in the organization counts toward the same limit.
- Rolling window: one second, resetting automatically.
- No headers: Deel says the API returns no rate-limit headers, so you learn of the limit only from a 429.
From the Rate limits page of Deel's developer documentation, November 21, 2026.
What do webhooks and the MCP server add?
Webhooks push events to you, and the MCP server lets AI agents call Deel operations as tools.
- Webhooks: real-time notifications for key events, each payload signed with SHA256, with subscriptions managed by API or in the Developer Center. Deel recommends webhooks for immediate updates and polling for an initial sync or as a backup.
- MCP server: at https://api.letsdeel.com/mcp, with tools at organization, worker and public permission levels. Deel lists OAuth2 or a personal access token for authentication and names Cursor, VS Code, Claude Desktop and ChatGPT as clients.
- Embedded: Deel also documents an Embedded model for building employment into your own product.
From Deel's webhooks and MCP pages, November 21, 2026. Review what an agent is allowed to do before you connect it to payroll data.
Frequently asked questions
Does Deel have an API?
Yes. Deel's developer documentation describes a REST API (OpenAPI 3.0.1), webhooks, an MCP server and a CLI, with a separate sandbox.
What is the Deel API rate limit?
Deel's documentation lists 5 requests per second per organization across all tokens, with a 429 error when exceeded and no rate-limit headers.
Can I connect Deel to an AI agent?
Deel publishes an MCP server at api.letsdeel.com/mcp. Clients authenticate with OAuth2 or a personal access token, per its documentation.
Can you build a Deel integration for us?
Yes. We build integrations between Deel, your accounting and HR systems and your automations. Book a call to start.
Need help with Deel?
We help small and mid-size teams compare hiring options and connect Deel to their accounting, HR and automation tools. See our Deel guides and services, and the workflow automation service.




