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",
      "permissionGroup": "Contingent",
      "payType": "PAYE",
      "payTypeId": 0,
      "engagementType": "CASUAL",
      "startDate": "2026-02-01",
      "fulltimeWork": "Mon-Fri (40 hours) - Hourly",
      "job": [
        {
          "workplaceId": 1,
          "primaryApproverId": "d7524879-953e-4788-b279-4f780973078e",
          "timesheetType": "Hourly",
          "timesheetLength": "Weekly",
          "jobDetails": {
            "title": "Software Engineer",
            "startDate": "2026-02-01",
            "timesheetStartDate": "2026-02-01"
          },
          "customerUuid": "68b527c6-b331-453e-a06f-cab8d9bc1ccf",
          "enableLeave": true,
          "timesheetEnable": true,
          "timesheetStart": "6",
          "variableTimesheet": true,
          "splitShifts": true,
          "timesheetForPayroll": true,
          "payRates": [
            {
              "rateType": "PAY_RATE",
              "rate": 25.5,
              "startDate": "2026-02-01"
            },
            {
              "rateType": "PAY_ONCOST",
              "rate": 3.2,
              "startDate": "2026-02-01"
            },
            {
              "rateType": "CHARGE_RATE",
              "rate": 35,
              "startDate": "2026-02-01"
            }
          ]
        }
      ],
      "payCycleId": "5cc42cbb-8443-47b4-8f82-66c0f4994f83"
    }
  ]
}'

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. Exactly one engagement.

Response

Request processed

idstringOptional

User id of the new employee (not a UUID), used by Get Employee and the update endpoints

statusenumOptional

The employee was created and activated

Allowed values:

messagestringOptional

Errors

400

Bad Request Error

409

Conflict Error

422

Unprocessable Entity Error

Authentication

Headers

Request

Response

Errors