Create Employee

Create an employee in Zeal's system. When you use this endpoint, you are simply creating an employee object. Note: this employee has not been onboarded yet and cannot be included in payroll run.


If any of the optional residential address fields are specified, the whole address must be suitable for taxation.
Error Code 34 will be returned otherwise.

Query the Resolve Taxable Location Endpoint for further details on why the address was not suitable.
Note: before creating an employee, a Work Location must be created and its ID must be provided during employee creation

attributetypedescription
successbooleanResponse status
dataobjectContains newly created Employee Object
errorsarrayContains a list of error objects which consists of:
message: Error message
code: Error code as described in Error codes
Language
Authentication
Header
Click Try It! to start a request and see the response here!