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 '{
  "personalDetails": {
    "nameFirst": "John",
    "nameLast": "Doe",
    "dateOfBirth": "2004-02-01",
    "gender": "Male",
    "contact": {
      "primaryEmail": "john.doe@example.com",
      "phone": {
        "countryCode": "91",
        "number": "7878009686"
      },
      "mobile": {
        "countryCode": "91",
        "number": "7878009686"
      }
    },
    "nameTitle": "Mr",
    "nameMiddle": "A",
    "nameKnownAs": "Johnny"
  },
  "engagement": [
    {
      "payrollCompanyId": "a169f209-b362-4a01-add2-c7bd7f0be6cb",
      "payType": "PAYE",
      "engagementType": "Casual",
      "startDate": "2026-02-01",
      "job": [
        {
          "workplaceId": 1,
          "primaryApproverId": "d7524879-953e-4788-b279-4f780973078e",
          "jobDetails": {
            "startDate": "2026-02-01",
            "title": "Software Engineer",
            "timesheetStartDate": "2026-02-01"
          },
          "customerUuid": "68b527c6-b331-453e-a06f-cab8d9bc1ccf",
          "enableLeave": true,
          "timesheetType": "Hourly",
          "timesheetEnable": true,
          "timesheetLength": "Weekly",
          "timesheetStart": "6",
          "variableTimesheet": true,
          "splitShifts": true,
          "timesheetForPayroll": true
        }
      ],
      "payCycleId": "5cc42cbb-8443-47b4-8f82-66c0f4994f83",
      "permissionGroup": "Contingent",
      "fulltimeWork": "Mon-Fri (40 hours) - Hourly",
      "payTypeId": 0
    }
  ]
}'

{
  "id": 1000,
  "userUuid": "rcjJX5K6v5XzoyNVWqHXS6",
  "remoteId": 55,
  "remoteSource": "classic",
  "isLocked": false,
  "personalDetails": {
    "uuid": "502519de-0287-4bb8-a3f1-d269eb850086",
    "userUuid": "rcjJX5K6v5XzoyNVWqHXS6",
    "nameInitials": "JD",
    "nameTitle": "Mr",
    "nameFirst": "John",
    "nameLast": "Doe",
    "nameMiddle": "A",
    "nameKnownAs": "Johnny",
    "dateOfBirth": "1990-01-15",
    "gender": "Male",
    "maritalStatus": "Single",
    "contact": {
      "primaryEmail": "john.doe@example.com",
      "payslipEmail": "john.doe.payslip@example.com",
      "phoneNumber": "+441234567890",
      "mobileNumber": "+447700123456",
      "emailPayslip": true,
      "sendNotification": true
    },
    "postalAddress": {},
    "emergencyContact": {},
    "remoteId": 55,
    "remoteSource": "classic",
    "nationality": "British"
  },
  "engagement": [
    {
      "uuid": "8a4f3e2d-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
      "payrollCompanyId": "1",
      "payType": "PAYE",
      "engagementType": "Full Time",
      "startDate": "2024-01-15",
      "terminationDate": "2023-01-15",
      "status": "ACTIVE",
      "hoursNormallyWorked": "MoreThan30",
      "remoteId": 101,
      "remoteSource": "classic",
      "job": [
        {}
      ]
    }
  ],
  "bank": {
    "uuid": "string",
    "accountName": "John Doe",
    "sortCode": "123456",
    "accountNumber": "12345678",
    "bankReference": "string",
    "buildingSocietyNumber": "string"
  },
  "tax_information": {
    "uuid": "string",
    "nationalInsuranceNumber": "AB123456C",
    "niTable": "A",
    "director": true,
    "week1Month1": true,
    "taxCode": "1257L",
    "haveP45Form": true,
    "haveStudentLoan": true,
    "studentLoanType": "None",
    "havePostGradLoan": true,
    "employeeDeclaration": "A",
    "taxInfoType": "TAX_CODE",
    "p45DemoLink": "string"
  },
  "lastSyncStatus": {
    "JOB": "synced",
    "TAX": "synced"
  },
  "employeeStatus": 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.

personalDetailsobjectRequired

Personal details of the employee

engagementlist of objectsRequired

Engagement and job assignment details

bankobjectOptional

Bank account details

taxInformationobjectOptional

Tax information

Response

Employee created successfully

idintegerOptional

Internal employee ID

userUuidstringOptional

remoteIdintegerOptional

remoteSourcestringOptional

isLockedbooleanOptional

Whether the employee account is locked

personalDetailsobjectOptional

engagementlist of objectsOptional

bankobjectOptional

tax_informationobjectOptional

Tax and payroll information for the active engagement

lastSyncStatusobjectOptional

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

employeeStatusintegerOptional

Numeric employee status code

employeeStateenumOptional

externalEmployeeNumberstringOptional

External employee number from integration (e.g. PaySpace)

Errors

400

Bad Request Error

Authentication

Headers

Request

Response

Errors