Employees

The employee objects allow you to keep your employee's data in a single place.

The API allows you to create, delete, and update your employees. You can retrieve individual employees as well as a list of all your employees.

Here is the list of all properties the employee object has:

employee

PropertyTypeRequiredDescription
namestringtrueThe full name of the employee.
emailstringtrueThe email address of the employee.
phonestringfalseThe primary phone number of the employee.
twitterHandlestringfalseThe twitter handle of the employee.
teamTeamfalseReference to the team the employee belongs to.
contactPersonbooleanfalseTrue if the employee is a contact person in his company.
billingPersonbooleanfalseTrue if the employee is the billing person of his company and receives all the invoices.
officeLocationfalseReference to the location the employee belongs to. It will default to the only location if left empty.
paymentDetailsarrayreadonlyArray containing all the names of the payment details added to the employee account.
createdAtdatereadonlyThe date when the employee has been created at.
createdByidreadonlyThe user that created the employee.
modifiedAtdatereadonlyThe date when the employee has been modified for the last time. If no update is made this field will match the createdAt field.
modifiedByidreadonlyThe user that did the last modification to the employee. If no update is made this field will match the createdBy field.
statusenumfalseThe employee status. It could be active, contact or former.
calculatedStatusenumreadonlyThe actual employee status calculated by the platform. Please, refer to this article for more information.