Create Employee | Deel. PayAndBill API Documentation

curl -X POST https://{{baseurl}}/draft-employee/create-from-draft-employee \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "userUuid": "rcjJX5K6v5XzoyNVWqHXS6",
  "personalDetails": {
    "nameTitle": "Mr",
    "nameFirst": "John",
    "nameLast": "Doe",
    "nameMiddle": "A",
    "nameKnownAs": "Johnny",
    "dateOfBirth": "2004-02-01",
    "contact": {
      "primaryEmail": "john.doe@example.com",
      "phone": {
        "countryCode": "91",
        "number": "7878009686"
      },
      "mobile": {
        "countryCode": "91",
        "number": "7878009686"
      }
    }
  },
  "engagement": [
    {
      "payrollCompanyId": "a169f209-b362-4a01-add2-c7bd7f0be6cb",
      "payCycleId": "5cc42cbb-8443-47b4-8f82-66c0f4994f83",
      "permissionGroup": "Contingent",
      "payType": "PAYE",
      "payTypeId": 0,
      "engagementType": "Casual",
      "startDate": "2026-02-01",
      "fulltimeWork": "Mon-Fri (40 hours) - Hourly",
      "job": [
        {
          "customerUuid": "68b527c6-b331-453e-a06f-cab8d9bc1ccf",
          "workplaceId": 1,
          "primaryApproverId": "d7524879-953e-4788-b279-4f780973078e",
          "timesheetType": "Hourly",
          "timesheetEnable": true,
          "enableLeave": true,
          "timesheetLength": "Weekly",
          "variableTimesheet": true,
          "splitShifts": true,
          "timesheetForPayroll": true,
          "timesheetStart": "6",
          "jobDetails": {
            "title": "Software Engineer",
            "startDate": "2026-02-01",
            "timesheetStartDate": "2026-02-01"
          }
        }
      ]
    }
  ]
}'

{
  "id": 1000,
  "userUuid": "rcjJX5K6v5XzoyNVWqHXS6",
  "remoteId": 55,
  "remoteSource": "classic",
  "personalDetails": {},
  "engagement": [
    {}
  ],
  "bank": {},
  "taxInformation": {},
  "lastSyncStatus": {},
  "employeeStatus": 1.1,
  "employeeState": "active",
  "externalEmployeeNumber": "string"
}

Create a new employee with personal details and engagement/job configuration.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

userUuidstringRequired

UUID of the user account

personalDetailsobjectRequired

Personal details of the employee

remoteIddoubleOptional

Remote ID from a third-party integration

remoteSourcestringOptional

Source system of the remote ID

engagementlist of objectsOptional

Engagement/job assignment details

bankobjectOptional

Bank account details

taxInformationobjectOptional

Tax information

Response

Employee created successfully

iddouble

Internal employee ID

userUuidstring

remoteIddouble

remoteSourcestring

personalDetailsobject

engagementlist of objects

bankobject

taxInformationobject

lastSyncStatusobject

Sync status per category (e.g. JOB, TAX, BANK, EMPLOYEE)

employeeStatusdouble

employeeStateenum

externalEmployeeNumberstring

Errors

400

Bad Request Error

Authentication

Headers

Request

Response

Errors