POST
/
api
/
hris
/
v1
/
employees

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-connector-token
string
required

Body

application/json
first_name
string | null
required

The employee's first name.

last_name
string | null
required

The employee's last name.

avatar
string | null

The URL of the employee's avatar image.

company
string | null

The ID of the employee's company.

country_code
string | null

The employee's country code

date_of_birth
string | null

The employee's date of birth.

department
string | null

The employee's department

designation
string | null

The employee's current designation/title

display_full_name
string | null

The employee's full name, to use for display purposes. If a preferred first name is available, the full name will include the preferred first name.

division
string | null

The employee's division

employee_number
string | null

The employee's number that appears in the third-party integration's UI.

employment_status
string | null

The employment status of the employee. Possible values include: ACTIVE, PENDING, INACTIVE, or - in cases where there is no clear mapping - the original value passed through.

ethnicity
string | null

The employee's ethnicity.

gender
string | null

The employee's gender.

groups
string[] | null

The IDs of the groups that the employee belongs to.

home_location
object | null

The employee's home address.

home_phone_number
string | null

The employee's home phone number.

manager
string | null

The employee ID of the employee's manager.

marital_status
string | null

The employee's filing status as related to marital status

middle_name
string | null

The employee's middle name.

mobile_phone_number
string | null

The employee's mobile phone number.

pay_group
string | null

The employee's pay group

personal_email
string | null

The employee's personal email.

preferred_name
string | null

The employee's preferred first name.

remote_created_at
string | null

When the third party's employee was created.

ssn
string | null

The employee's social security number.

start_date
string | null

The date that the employee started working. If an employee was rehired, the most recent start date will be returned.

termination_date
string | null

The employee's termination date.

title
string | null

The employee's Title.

username
string | null

The employee's username that appears in the remote UI.

work_email
string | null

The employee's work email.

work_location
object | null

The employee's work address.

Response

200 - application/json
message
string
required
success
boolean
required
errors
object | null