# Deel — Pipedream Connect

> Deel is the all-in-one HR platform for global teams. It helps companies simplify every aspect of managing an international workforce, from culture and onboarding, to local payroll and compliance.

- API slug: `deel` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Human Resources
- Website: https://www.deel.com
- Managed OAuth scopes: `contracts:read` · `contracts:write` · `tasks:read` · `tasks:write` · `adjustments:read` · `adjustments:write` · `timesheets:read` · `forms:read` · `payslips:read` · `time-tracking:read` · `time-tracking:write` · `invoice-adjustments:write` · `benefits:read`
- This page (HTML): https://pipedream.com/apps/deel
- Tools: 24 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: deel`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "deel",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Amend EOR Contract:
const result = await mcp.callTool({
  name: "deel-amend-eor-contract",
  arguments: {
    contractId: "Contract ID",
    effectiveDate: "Effective Date",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Deel endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.letsdeel.com/rest/v2/contracts

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkubGV0c2RlZWwuY29tL3Jlc3QvdjIvY29udHJhY3Rz?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "deel-amend-eor-contract",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    deel: { authProvisionId: "apn_xxxxxxx" },
    contractId: "Contract ID",
    effectiveDate: "Effective Date",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (24)

### `deel-amend-eor-contract` — Amend EOR Contract (Write)

Create a new amendment for an EOR (employer of record) Deel contract — change salary, currency, job title, employment type, work hours, holidays, or notice period. All amendment fields are optional; provide only the fields you want to change. effective_date and start_date must be in ISO 8601 format…

Full schema: https://pipedream.com/apps/deel/actions/amend-eor-contract.md

### `deel-amend-ic-contract` — Amend IC Contract (Write)

Update an independent contractor (IC) contract in Deel — change the rate, currency, payment scale, frequency, job title, or scope of work. All amendment fields are optional; provide only the fields you want to change. effective_date is required — use today's date or earlier (ISO 8601 format, e.g…

Full schema: https://pipedream.com/apps/deel/actions/amend-ic-contract.md

### `deel-create-adjustment` — Create Adjustment (Write)

Create a payroll line-item adjustment for an EOR or GP contract in Deel (bonus, deduction, expense, etc.). This uses multipart/form-data and supports an optional file attachment (e.g., a receipt). country must be an ISO 3166-1 alpha-2 code (e.g., US, DE). adjustment_category_id is required…

Full schema: https://pipedream.com/apps/deel/actions/create-adjustment.md

### `deel-create-contract-task` — Create Contract Task (Write)

Add a task or milestone to a Deel payg_tasks contractor contract. Tasks represent discrete deliverables with a defined amount and submission date. The contract must be in active status (fully signed by both parties) to accept tasks. Set is_auto_approved to true to automatically approve the task…

Full schema: https://pipedream.com/apps/deel/actions/create-contract-task.md

### `deel-create-eor-contract` — Create EOR Contract (Write)

Create an EOR (employer of record) contract quote in Deel to hire a full-time employee in a country where your company doesn't have a legal entity. Use Get EOR Hiring Guide first to understand mandatory fields and compliance requirements for the target country. employee_nationality and…

Full schema: https://pipedream.com/apps/deel/actions/create-eor-contract.md

### `deel-create-gp-contract` — Create Global Payroll Contract (Write)

Create a Global Payroll (GP) contract in Deel to add an employee to your domestic payroll system. Use this when the employee works in a country where your company already has a legal entity. employment_type must be one of: Full-time, Part-time (case-sensitive). compensation_scale must be one of…

Full schema: https://pipedream.com/apps/deel/actions/create-gp-contract.md

### `deel-create-ic-contract` — Create IC Contract (Write)

Create a new independent contractor (IC) contract in Deel. Use this to hire a contractor with a fixed rate, pay-as-you-go, or milestone-based arrangement. type must be one of: ongoing_time_based (recurring fixed rate), payg_tasks (per-task), payg_milestones (milestones), pay_as_you_go_time_based…

Full schema: https://pipedream.com/apps/deel/actions/create-ic-contract.md

### `deel-create-invoice-adjustment` — Create Invoice Adjustment (Write)

Add a bonus, deduction, commission, expense, or other financial adjustment to an IC contractor's Deel invoice. type must be one of: bonus, commission, deduction, expense, other, overtime, time_off, vat. Set is_auto_approved to true to auto-approve without manual review. Use List Contracts to find…

Full schema: https://pipedream.com/apps/deel/actions/create-invoice-adjustment.md

### `deel-create-shift-rate` — Create Shift Rate (Write)

Create a named shift rate for GP (Global Payroll) time tracking in Deel. Shift rates define how time-tracked work is compensated. external_id is a unique identifier you assign (e.g., rate-overtime-001); use this ID when creating shifts via Create Shifts. type must be one of: MULTIPLIER_PERCENTAGE…

Full schema: https://pipedream.com/apps/deel/actions/create-shift-rate.md

### `deel-create-shifts` — Create Shifts (Write)

Create one or more time tracking shifts for a GP (Global Payroll) contract in Deel. Each shift records worked time with a date, duration, and associated shift rate. shifts must be a JSON array of shift objects. Each shift requires: description (string), external_id (your unique ID), shift_type…

Full schema: https://pipedream.com/apps/deel/actions/create-shifts.md

### `deel-get-contract` — Get Contract (Read-only)

Retrieve full details for a specific Deel contract by ID, including worker info, compensation, status, and timeline. Works for IC, EOR, and GP contract types. Use List Contracts to find contract IDs. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/get-contract.md

### `deel-get-contract-preview` — Get Contract Preview (Read-only)

Retrieve the full contract agreement text as HTML for a specific Deel contract. Use this when the user wants to read, review, or summarize the actual contract document. Works for IC and EOR contracts. Use List Contracts to find contract IDs. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/get-contract-preview.md

### `deel-get-eor-benefits` — Get EOR Benefits (Read-only)

List available EOR (employer of record) benefits offered through Deel for a specific country and employment context. Returns benefit names, types, descriptions, and availability. Use this when a user asks about what benefits they can offer EOR employees in a specific country. country_code must be…

Full schema: https://pipedream.com/apps/deel/actions/get-eor-benefits.md

### `deel-get-eor-contract-form` — Get EOR Contract Form (Read-only)

Retrieve the EOR contract form field definitions for a specific country, including field names, types, validation rules, and required vs optional fields. Use this to understand exactly what data is needed before creating an EOR contract. country_code must be an ISO 3166-1 alpha-2 code (e.g., DE for…

Full schema: https://pipedream.com/apps/deel/actions/get-eor-contract-form.md

### `deel-get-eor-hiring-guide` — Get EOR Hiring Guide (Read-only)

Retrieve the mandatory fields, compliance requirements, and hiring constraints for creating an EOR (employer of record) contract in a specific country. Use this before creating an EOR contract to understand what information is required and what restrictions apply (e.g., minimum salary, mandatory…

Full schema: https://pipedream.com/apps/deel/actions/get-eor-hiring-guide.md

### `deel-list-contract-adjustments` — List Contract Adjustments (Read-only)

List all adjustments (bonuses, deductions, expenses, etc.) for a specific Deel contract. Works for both IC and EOR contracts. Optionally filter by date range. Use List Contracts to find the contract ID. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/list-contract-adjustments.md

### `deel-list-contract-tasks` — List Contract Tasks (Read-only)

List all tasks for a specific Deel IC contract. Returns task IDs, descriptions, amounts, statuses, and submission dates. Use task IDs with Review Contract Task to approve or decline pending tasks. Use List Contracts to find the contract ID. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/list-contract-tasks.md

### `deel-list-contracts` — List Contracts (Read-only)

List and search all contracts in Deel across IC (independent contractor), EOR (employer of record), and GP (global payroll) types. Use this to find contract IDs, check statuses, or browse the contractor/employee roster. Supports filtering by search term, status, contract type, team, and country…

Full schema: https://pipedream.com/apps/deel/actions/list-contracts.md

### `deel-list-eor-payslips` — List EOR Payslips (Read-only)

List payslips for a specific EOR (employer of record) employee in Deel. Returns payslip IDs, pay periods, gross/net amounts, and download links. Use Get Contract to find the worker ID from a contract's worker details. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/list-eor-payslips.md

### `deel-list-gp-payslips` — List GP Payslips (Read-only)

List payslips for a specific GP (Global Payroll) employee in Deel. Returns payslip IDs, pay periods, gross/net amounts, and download links. Use Get Contract to find the worker ID from a contract's worker details. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/list-gp-payslips.md

### `deel-list-timesheets` — List Timesheets (Read-only)

List IC contractor timesheets in Deel with optional filters for contract, status, date range, and contract type. Returns timesheet IDs, contract info, hours worked, status, and pay period. Use List Contracts to find contract IDs for filtering. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/list-timesheets.md

### `deel-review-contract-task` — Review Contract Task (Write)

Approve or decline a contractor task on a Deel IC contract. status must be approved or declined. If declining, provide a reason explaining why. Use List Contract Tasks to find task IDs. Use List Contracts to find the contract ID. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/review-contract-task.md

### `deel-send-contract-invitation` — Send Contract Invitation (Write)

Send a contract invitation email to a worker for a specific Deel contract. Use this after creating a contract to notify the worker and prompt them to sign. Use List Contracts to find the contract ID. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/send-contract-invitation.md

### `deel-sign-contract` — Sign Contract (Write)

Sign a Deel contract as the client/employer. Use this to countersign a contract that has been sent to and signed by the contractor. client_signature is typically the full legal name of the signing party. Use List Contracts to find the contract ID. See the documentation

Full schema: https://pipedream.com/apps/deel/actions/sign-contract.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt