Create Employee

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

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
Credentials
Header
Click Try It! to start a request and see the response here!