Create New Employee

An employee may be created with a status of 'Incomplete' by specifying at least the minimum fields:

{
    "firstName": "String",
    "surname": "String",
    "identityCardNumber": "String",
    "emailAddress": "String",
    "gender": "String", // Male or Female
    "nationality": "String",
    "dateOfBirth": "YYYY-MM-DD",
    "employmentType": "String", // Permanent or Part Time or Management or Contract or Intern or Other
    "startDate": "YYYY-MM-DD",
    "pcbTaxBorne": "bool",
    "socsoType": "String", // NotApplicable or EmploymentInjuryAndInvalidityScheme or EmploymentInjuryScheme
    "maritalStatus": "String", // Single or MarriedAndSpouseIsWorking or MarriedAndSpouseIsNotWorking or DivorcedOrWidowed
    "residentialAddressType": "String", // LocalAddress or ForeignAddress or LocalCareOfAddress
    "residentialSuburb": "String",
    "residentialState": "String",
    "residentialBlockNumber": "String",
    "residentialUnitNumber": "String",
    "residentialLevelNumber": "String",
    "residentialPostCode": "String",
    "residentialStreetAddress": "String",
    "residentialStreetName": "String", // Resident
    "residenceType": "String" // Malaysian or PermanentResidence or NonMalaysian
}

For an employee record to be considered 'Complete' the following groups of data are required:

• Basic Details (Name, Start Date, Date of Birth, Gender and Address Details)

• Pay Run Defaults (Default Pay Category, Pay Schedule and Location)

• Locations (at least one)

• Bank Account/s (at least one)

Request

POST ../api/v1/client/employee

Request body

The request body takes a complete employee model resource containing the following writable properties:

{
    "anniversaryDate": "date-time",
    "automaticallyPayEmployee": "string",
    "bankAccount1_AccountName": "string",
    "bankAccount1_AccountNumber": "string",
    "bankAccount1_AllocatedPercentage": "double",
    "bankAccount1_BankCode": "string",
    "bankAccount1_BankName": "string",
    "bankAccount1_BranchCode": "string",
    "bankAccount1_FixedAmount": "double",
    "bankAccount1_MyBankCode": "string",
    "bankAccount2_AccountName": "string",
    "bankAccount2_AccountNumber": "string",
    "bankAccount2_AllocatedPercentage": "double",
    "bankAccount2_BankCode": "string",
    "bankAccount2_BankName": "string",
    "bankAccount2_BranchCode": "string",
    "bankAccount2_FixedAmount": "double",
    "bankAccount2_MyBankCode": "string",
    "bankAccount3_AccountName": "string",
    "bankAccount3_AccountNumber": "string",
    "bankAccount3_AllocatedPercentage": "double",
    "bankAccount3_BankCode": "string",
    "bankAccount3_BankName": "string",
    "bankAccount3_BranchCode": "string",
    "bankAccount3_FixedAmount": "double",
    "bankAccount3_MyBankCode": "string",
    "dateCreated": "date-time",
    "dateOfBirth": "date-time",
    "dependentChildren": "string",
    "eisExempt": "string",
    "emailAddress": "string",
    "emergencyContact1_Address": "string",
    "emergencyContact1_AlternateContactNumber": "string",
    "emergencyContact1_ContactNumber": "string",
    "emergencyContact1_Name": "string",
    "emergencyContact1_Relationship": "string",
    "emergencyContact2_Address": "string",
    "emergencyContact2_AlternateContactNumber": "string",
    "emergencyContact2_ContactNumber": "string",
    "emergencyContact2_Name": "string",
    "emergencyContact2_Relationship": "string",
    "employingEntityId": "string",
    "employmentType": "string",
    "endDate": "date-time",
    "epfContributionType": "string",
    "epfNumber": "string",
    "epfRate": "string",
    "ethnicity": "string",
    "externalId": "string",
    "firstName": "string",
    "gender": "string",
    "homePhone": "string",
    "hoursPerDay": "double",
    "hoursPerWeek": "double",
    "id": "int32",
    "identityCardNumber": "string",
    "incomeTaxNumber": "string",
    "isEnabledForTimesheets": "string",
    "jobTitle": "string",
    "leaveAccrualStartDateType": "string",
    "leaveAnniversarySetting": "string",
    "leaveAnniversarySettingDate": "date-time",
    "leaveTemplate": "string",
    "leaveYearStart": "date-time",
    "legalName": "string",
    "locations": "string",
    "maritalStatus": "string",
    "middleName": "string",
    "mobilePhone": "string",
    "nationality": "string",
    "overrideTemplateRate": "string",
    "passportIssuingCountry": "string",
    "passportNumber": "string",
    "payConditionRuleSet": "string",
    "payRateTemplate": "string",
    "paySchedule": "string",
    "paySlipNotificationType": "string",
    "pcbTaxBorne": "boolean",
    "postalAddressLine2": "string",
    "postalAddressLine3": "string",
    "postalAddressType": "string",
    "postalBlockNumber": "string",
    "postalCountry": "string",
    "postalLevelNumber": "string",
    "postalPostCode": "string",
    "postalState": "string",
    "postalStreetAddress": "string",
    "postalStreetName": "string",
    "postalSuburb": "string",
    "postalUnitNumber": "string",
    "preferredName": "string",
    "primaryLocation": "string",
    "primaryPayCategory": "string",
    "rate": "double",
    "rateUnit": "string",
    "religion": "string",
    "reportingDimensionValues": "string",
    "residenceStatus": "string",
    "residenceType": "string",
    "residentialAddressLine2": "string",
    "residentialAddressLine3": "string",
    "residentialAddressType": "string",
    "residentialBlockNumber": "string",
    "residentialCountry": "string",
    "residentialLevelNumber": "string",
    "residentialPostCode": "string",
    "residentialState": "string",
    "residentialStreetAddress": "string",
    "residentialStreetName": "string",
    "residentialSuburb": "string",
    "residentialUnitNumber": "string",
    "rosteringNotificationChoices": "string",
    "socsoType": "string",
    "ssfwNumber": "string",
    "startDate": "date-time",
    "status": "string",
    "surname": "string",
    "tags": "string",
    "terminationReason": "string",
    "tieredLeaveTemplate": "string",
    "title": "string",
    "workPhone": "string",
    "workTypes": "string",
    "workerStatus": "string"
}