First-party app
Deel

Deel

Manage Deel contracts, people, time off, timesheets and invoice adjustments.

stable Human ResourcesFinance & Accounting

About

Deel ships in the w6w first-party pack. It declares 25 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.deel
Version
0.1.1
Author
w6w
Licence
MIT
Categories
Human Resources · Finance & Accounting

Overview

Deel manages contracts, people, time off, timesheets and invoice adjustments for a global workforce, exposing what an HR or finance workflow needs without going near payroll or employment-record changes. Contracts can be listed, read and terminated; workers’ profiles, personal details and department assignments can be read and updated; time off can be requested, approved or cancelled against a worker’s actual leave balance; and timesheets and invoice adjustments — bonuses, expenses, deductions — can be logged against a contract.

Money-moving actions are marked as non-idempotent on purpose, since retrying a milestone, adjustment or timesheet submission pays twice rather than correcting a mistake. Time-off requests can either enter Deel’s own approval chain or be created directly in a given status, for a workflow that has already collected approval elsewhere.

Webhooks can be registered and listed so a workflow can react to Deel’s own events rather than polling. Employment-record administration — EOR and global payroll worker data, the applicant tracking system, immigration and compliance screening — is deliberately out of scope; those are separate products with their own legal weight and belong to their own integrations.

Build with Deel

Three routes to the same 25 actions. The Workflow tab is generated from Deel's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

List adjustment categories

adjustment-category-list

List the bonus, expense and deduction categories this organization has.

Get a contract

contract-get

Retrieve one contract with its terms and current status.

List contracts

contract-list

List contracts, filtered by type, status, team or country.

Create a milestone

contract-milestone-create

Add a payable milestone to a contract.

List a contract's milestones

contract-milestone-list

List the milestones on a milestone-based contract.

Terminate a contract

contract-terminate

Request termination of a contract.

Create an invoice adjustment

invoice-adjustment-create

Add a bonus, expense or deduction to a contract's next invoice.

List invoice adjustments

invoice-adjustment-list

List bonuses, expenses and deductions across contracts.

List legal entities

legal-entity-list

List the legal entities this organization contracts through.

List a lookup

lookup-list

Read one of Deel's reference lists — countries, currencies, job titles, and so on.

Move a person to a department

person-department-update

Set a worker's department.

Get a person

person-get

Retrieve one worker's profile.

List people

person-list

List the workers in this organization.

Get a person's personal information

person-personal-info-get

Read a worker's personal details — a separate, more sensitive endpoint.

Request time off

time-off-create

Create a time-off request for a worker.

Cancel a time-off request

time-off-delete

Withdraw a time-off request.

List a person's leave balances

time-off-entitlement-list

Read how much leave a worker has accrued and used.

List a person's time off

time-off-list

List one worker's time-off requests.

Approve or deny time off

time-off-review

Review a pending time-off request.

Submit a timesheet

timesheet-create

Log work against a contract.

List timesheets

timesheet-list

List submitted timesheets, optionally filtered by contract or status.

Create a webhook

webhook-create

Register a URL to receive Deel events.

Delete a webhook

webhook-delete

Stop Deel sending events to a URL.

List webhook event types

webhook-event-list

List the events Deel can send to a webhook.

List webhooks

webhook-list

List the webhooks registered on this organization.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Deel's real ids.

{
  "manifestVersion": "2",
  "name": "deel-example",
  "steps": [
    {
      "id": "contract-get",
      "uses": {
        "app": "io.w6w.deel",
        "action": "contract-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "contractId": "<contractId>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get a contract

    read
    contract-get
  • List adjustment categories

    read
    adjustment-category-list
  • List contracts

    read
    contract-list
  • Create a milestone

    perform
    contract-milestone-create
  • List a contract's milestones

    read
    contract-milestone-list

+20 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Deel, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Deel. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "contract-get",
  payload: {
    contractId: "<value>",
    // expand: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action contract-get --payload '{"contractId":"<value>"}'

Give an AI agent Deel — without giving it Deel's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.deel#contract-get",
    "input": {
      "contractId": "<contractId>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Deel connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Deel's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Deel itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Deel declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Deel platform status

Deel's Statuspage exists but is not public, so no machine-readable status surface is available.

quota

API rate-limit headroom

Requests remaining on this token, read off the `x-ratelimit-*` headers Deel sends on every response.