Consultants in a BoxDeelDeel guides
Deel API

Deel API: tokens, limits, webhooks and the MCP server

Short answer

Per Deel's developer documentation on November 21, 2026, the Deel API is REST (OpenAPI 3.0.1) at api.letsdeel.com/rest with a separate sandbox, authenticated by organization, personal or worker tokens or OAuth2. It allows 5 requests per second per organization and sends no rate-limit headers, signs webhook payloads with SHA256, and Deel also publishes an MCP server for AI agents.

Last reviewed against the vendors' own pages. See sources.

How do you authenticate to the Deel API?

Per Deel's developer documentation, all requests use HTTPS and a Bearer token, or OAuth2.

TokenRepresentsUsed for, per Deel
Organization tokenThe whole organizationServer-to-server: contracts, payroll, invoices, SCIM
Personal tokenOne userContract creation, SSO integrations, user-scoped actions
Worker tokenOne EOR workerEmbedded 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.

Sources

Last reviewed . Vendor plans and prices change often; every product claim and price on this page was checked against the vendor pages below on that date. Anything we could not verify was left out.

  1. Deel developer documentation (Deel)
  2. Authentication (Deel developer documentation)
  3. Rate limits (Deel developer documentation)
  4. Webhooks (Deel developer documentation)
  5. Deel MCP server (Deel developer documentation)

Consultants in a Box is an independent consultancy. This page is not published or endorsed by Deel. Prices shown are Deel's listed starting prices, not ours. Deel is a trademark of its owner.

Setting up or connecting Deel?

Start with the free business analysis, or book a call and we will talk through who you hire and pay and a practical first step.

Book a free consultation

Tell us about your team and the software you need help with. We'll follow up to schedule a time to talk.

Open the form on its own page

Talk to a person

The fastest way is to pick a time. Prefer to write? Leave a message and we will email you back, usually the same business day.

Book a free call

By sending this you agree to our Terms and Privacy Policy.