Create a Global Payroll worker | Deel

curl -X POST https://api.letsdeel.com/rest/gp/workers \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": {
    "team_id": "0a9e5d74-2c18-4b6f-8d3a-5f1c7b92e406",
    "job_title": "Software Engineer",
    "start_date": "2026-11-02",
    "compensation": {
      "scale": "ANNUALLY",
      "amount": 65000,
      "currency": "EUR"
    },
    "home_address": {
      "zip": "1100-053",
      "city": "Lisbon",
      "street": "Rua Augusta 100",
      "country": "PT"
    },
    "personal_info": {
      "email": "ana.silva@example.com",
      "last_name": "Silva",
      "first_name": "Ana"
    },
    "employment_type": "FULL_TIME",
    "legal_entity_id": "b4f1a6c2-5d3e-4f8a-9c21-7e0d6a3b1f55",
    "payroll_group_id": "pg_2f9c1e7a"
  }
}'

{
  "data": {
    "id": "c9f8a1b2-1234-5678-9abc-1234567890ab",
    "type": "global_payroll",
    "client": {
      "legal_entity": {
        "name": "Acme Corporation Ltd."
      }
    },
    "status": "completed",
    "employee": {
      "id": "9b2e1c5a-6f3d-4a8b-9c1e-2d4f6a8b0c3e",
      "email": "jane.doe@example.com",
      "last_name": "Doe",
      "first_name": "Jane",
      "employee_number": "EMP-1001"
    },
    "job_title": "Designer",
    "created_at": "2024-06-15T10:30:00.000Z",
    "employment": {
      "type": "Full-time",
      "state": "CA",
      "country": "US",
      "end_date": "2025-06-15T00:00:00.000Z",
      "holidays": {
        "allowance": 20,
        "start_date": "2024-01-01T00:00:00.000Z"
      },
      "start_date": "2024-01-01T00:00:00.000Z",
      "is_work_visa_required": true
    },
    "compensation_details": {
      "scale": "YEAR",
      "salary": 85000,
      "currency": "USD"
    }
  }
}

Creates a Global Payroll worker and their contract in a single call, so API clients and partner integrations can onboard Global Payroll workers directly instead of using the legacy POST /rest/contracts/gp flow. No invitation email is sent to the worker unless the request asks for one.

Token scopes: contracts:write

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-12.

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Request

Worker, contract and compensation details.

dataobjectRequired

Response

The worker and their contract were created. data.id is the contract id; data.employee.id is the worker id to use with the other Global Payroll worker endpoints.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error