At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
DEEL_API_TOKENis sent as theBearerprefixedAuthorizationheader. - Docs: https://developer.deel.com/docs/authentication
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
DEEL_API_TOKEN | Yes | Deel API access token (personal or organization token, generated in the Deel app under Apps & Integrations > Developer) Docs. |
Setup
- Generate an API token: Sign in to the Deel app (https://app.deel.com), open Apps & Integrations and go to the API access / developer section, then click Generate new token. Choose an organization token (recommended for automation; never expires and is not tied to a user) or a personal token, and select the scopes the tools need: contracts:read, people:read, accounting:read, timesheets:read, and timesheets:write if you want to submit timesheets.
- Optional: use the sandbox for testing: Deel provides an isolated sandbox with sample data that never triggers real payments or contracts. Create a sandbox account from the developer center in the Deel platform (sandbox app at demo.letsdeel.com) and generate a sandbox token there. The sandbox API base URL is https://api-sandbox.demo.deel.com/rest/v2 - to test against it, point a copy of this connector at that host.
- Set the environment variable: Add DEEL_API_TOKEN to your .env with the generated token.
- Verify access: Run List Contracts. If you get a 403, check that the token includes the required scope for the endpoint.
- All requests must be made over HTTPS; the token is sent as Authorization: Bearer <token>.
- Personal tokens are limited to what the generating user can access and expire when that user leaves the organization; organization tokens do not expire.
- This connector targets the production API (api.letsdeel.com). Sandbox and production use separate credentials.
Tools
| Tool | Access | Description |
|---|---|---|
| List Contracts | Read | List contracts in the Deel account, optionally filtered by contract type |
| Get Contract | Read | Retrieve full details of a single contract by ID |
| List People | Read | List people (workers) in the organization with their employment details |
| Get Person | Read | Retrieve a single person (worker) with their employments, manager, and direct reports |
| List Invoices | Read | List worker invoices; only paid invoices are returned unless status=all is passed |
| List Timesheets | Read | List timesheet entries, optionally filtered to a single contract |
| Create Timesheet Entry | Write | Submit a timesheet entry (work performed) for a contractor contract |
| Review Timesheet | Write | Approve or decline a submitted timesheet entry; approved hours flow onto the contractor’s invoice |
Example prompts
- List the contracts in my Deel account and summarize them by type and status.
- Show me the people in my Deel organization grouped by hiring status and country.
- List Deel invoices issued in the last month and summarize the totals.