post https://api.zeal.com/employees
Create a W-2 employee.
This endpoint creates an Employee Object to represent a W-2 employee.
Note: This employee cannot be included in a payroll run until they are also onboarded.
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
Returns
attribute | type | description |
---|---|---|
success | boolean | Response status |
data | object | Contains newly created Employee Object |
errors | array | Contains a list of error objects which consists of:message : Error messagecode : Error code as described in Error codes |