> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deel

> Read Deel contracts, workers, invoices, and timesheets for global payroll and contractor management, with optional timesheet submission

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `DEEL_API_TOKEN` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://developer.deel.com/docs/authentication](https://developer.deel.com/docs/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| 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](https://developer.deel.com/docs/api-tokens-1). |

## Setup

1. **Generate an API token**: Sign in to the Deel app ([https://app.deel.com](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.
2. **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](https://api-sandbox.demo.deel.com/rest/v2) - to test against it, point a copy of this connector at that host.
3. **Set the environment variable**: Add DEEL\_API\_TOKEN to your .env with the generated token.
4. **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.

Provider API reference: [https://developer.deel.com/docs](https://developer.deel.com/docs)

## 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.