Updates the personal details for the specified employee


PUT https://api.nzpayroll.co.nz/api/v2/ess/{employeeId}/personaldetails

Path parameters

Parameter name Value Description Additional
employeeId string Required

Request body

The request body takes a complete NzEssEmployeeDetailsEditModel resource, containing the following writable properties:

    "dateOfBirth": "date-time",
    "email": "string",
    "firstName": "string",
    "gender": "string",
    "homePhone": "string",
    "id": "int32",
    "isPostalAddressSameAsResidential": "boolean",
    "middleName": "string",
    "mobilePhone": "string",
    "otherName": "string",
    "postalAddress": {
        "addressLine2": "string",
        "country": "string",
        "countryId": "string",
        "isManualAddress": "boolean",
        "isOutOfRegion": "boolean",
        "postcode": "string",
        "state": "string",
        "streetAddress": "string",
        "suburb": "string",
        "suburbId": "int32"
    "previousSurname": "string",
    "residentialAddress": {
        "addressLine2": "string",
        "country": "string",
        "countryId": "string",
        "isManualAddress": "boolean",
        "isOutOfRegion": "boolean",
        "postcode": "string",
        "state": "string",
        "streetAddress": "string",
        "suburb": "string",
        "suburbId": "int32"
    "surname": "string",
    "titleId": "int32",
    "workPhone": "string"


Name Type Description
dateOfBirth date-time Nullable
email string String
firstName string String
gender string String
homePhone string String
id int32 Int32
isPostalAddressSameAsResidential boolean Nullable
middleName string String
mobilePhone string String
otherName string String
postalAddress object NzAddressModel
postalAddress.addressLine2 string String
postalAddress.country string String
postalAddress.countryId string String
postalAddress.isManualAddress boolean Nullable
postalAddress.isOutOfRegion boolean Nullable
postalAddress.postcode string String
postalAddress.state string String
postalAddress.streetAddress string String
postalAddress.suburb string String
postalAddress.suburbId int32 Nullable
previousSurname string String
residentialAddress object NzAddressModel
residentialAddress.addressLine2 string String
residentialAddress.country string String
residentialAddress.countryId string String
residentialAddress.isManualAddress boolean Nullable
residentialAddress.isOutOfRegion boolean Nullable
residentialAddress.postcode string String
residentialAddress.state string String
residentialAddress.streetAddress string String
residentialAddress.suburb string String
residentialAddress.suburbId int32 Nullable
surname string String
titleId int32 Nullable
workPhone string String


The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK