Update Employee

Update an employee's fields in BambooHR.

If the employee is on, or is being added to, a pay schedule that syncs with TRAXPayroll, then your update must include all of these fields for the action to succeed:

Employee #, First Name, Last Name, Birth Date, SSN, Gender, Marital Status, Hire Date, Address Line 1, City, State, Country, Employment Status, Overtime Status, Pay Type, Pay Rate, Pay Period, Location, Department, and Division.

Options

Field	Definition	Type	Required
Pass Empty Values?	Determine whether to send empty (null) input values, clearing the field value in BambooHR. If Yes, the card updates all fields selected and filled in with valid values. However, any fields selected but left blank are cleared, except special fields. All fields that aren't selected remain unchanged. If No, the card updates all fields selected and filled in with valid values. All fields that aren't selected or left blank remain unchanged.	Dropdown	TRUE

Field

Definition

Type

Required

Pass Empty Values?

Determine whether to send empty (null) input values, clearing the field value in BambooHR.

If Yes, the card updates all fields selected and filled in with valid values. However, any fields selected but left blank are cleared, except special fields. All fields that aren't selected remain unchanged.

If No, the card updates all fields selected and filled in with valid values. All fields that aren't selected or left blank remain unchanged.

Dropdown

TRUE

Input

Field	Definition	Type	Required
ID	The employee's ID.	Text	TRUE
ACA Status	The employee's ACA (Affordable Care Act) status. This field can't be updated directly but is calculated based on mappings for employment status found on the employmentStatus table. Available options: contractor, full-time, intern-eligible, intern-ineligible, part-time-eligible, part-time-ineligible, or seasonal.	Dropdown	FALSE
Address Line 1	The employee's first address line.	Text	FALSE
Address Line 2	The employee's second address line.	Text	FALSE
Birth Date	The date the employee was born.	Text	FALSE
Bonus Amount	The amount of the most recent bonus.	Text	FALSE
Bonus Comment	Comment about the most recent bonus.	Text	FALSE
Bonus Date	The date of the last bonus.	Text	FALSE
Bonus Reason	The reason for the most recent bonus.	Text	FALSE
City	The employee's city.	Text	FALSE
Commission Amount	The amount of the most recent commission.	Text	FALSE
Commission Comment	Comment about the most recent commission.	Text	FALSE
Compensation Change Reason	Reason for the most recent compensation change.	Text	FALSE
Country	The employee's country.	Text	FALSE
Department	The employee's current department.	Text	FALSE
Display Name	The employee's name, displayed in a format configured by the user. This is a read-only value.	Text	FALSE
Division	The employee's current division.	Text	FALSE
EEO Job Category	The employee's EEO job category. The US Equal Employment Opportunity Commission defines these categories.	Text	FALSE
Employee #	The employee number assigned by your company.	Text	FALSE
Employment Status	The employee's current employment status. Options are customized by account. This is a read-only value.	Text	FALSE
Ethnicity	The employee's ethnicity.	Text	FALSE
First Name	The employee's first name.	Text	FALSE
Gender	The employee's gender: Male or Female.	Text	FALSE
Hire Date	The date the employee was hired.	Text	FALSE
Home Email	The employee's home email address.	Text	FALSE
Home Phone	The employee's home phone number.	Text	FALSE
Include in Payroll	Should employee be included in payroll: Yes or No.	Text	FALSE
Job Title	The current value of the employee's job title. Updating this field creates a new row in the position history.	Text	FALSE
Last Name	The employee's family name.	Text	FALSE
Location	The employee's current location.	Text	FALSE
Marital Status	The employee's marital status: Single, Married, or Domestic Partnership.	Text	FALSE
Middle Name	The employee's middle name.	Text	FALSE
Mobile Phone	The employee's mobile phone number.	Text	FALSE
NIN	The employee's NIN number.	Text	FALSE
National ID	The employee's National ID number.	Text	FALSE
Nationality	The employee's nationality.	Text	FALSE
Original Hire Date	The date the employee was originally hired.	Text	FALSE
Overtime Status	The FLSA Overtime Status: Exempt or Non-exempt.	Text	FALSE
Pay Group	The custom pay group to which the employee belongs.	Text	FALSE
Pay Period	The employee's current pay per: Hour, Day, Week, Month, Quarter, or Year.	Text	FALSE
Pay Rate	The employee's current pay rate. For example, $8.25.	Text	FALSE
Pay Schedule	The employee's current pay schedule.	Text	FALSE
Pay Type	The employee's current pay type: hourly, salary, commission, exception hourly, monthly, weekly, piece rate, contract, daily, or pro rata.	Text	FALSE
Preferred Name	The employee's preferred name.	Text	FALSE
SIN	The employee's Canadian Social Insurance Number.	Text	FALSE
SSN	The employee's Social Security number.	Text	FALSE
Standard Hours Per Week	The number of hours the employee works in a standard week.	Text	FALSE
State	The employee's state or province.	Text	FALSE
Status	The employee's employee status: Active or Inactive.	Text	FALSE
Time Tracking Enabled	Should time tracking be enabled for the employee: Yes or No.	Text	FALSE
Work Email	The employee's work email address.	Text	FALSE
Work Ext.	The employee's work phone extension (if any).	Text	FALSE
Work Phone	The employee's work phone number, without extension.	Text	FALSE
Zip Code	The employee's ZIP code.	Text	FALSE

Output

Field	Definition	Type
Result
Status Code	Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example: A 200 status code indicates success where the resource was updated. A 422 error indicates that the request wasn't processed, with an accompanying informational message.	Number

Field

Definition

Type

Result

Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

A 200 status code indicates success where the resource was updated.
A 422 error indicates that the request wasn't processed, with an accompanying informational message.

Number

Update Employee

Options

Input

Output

Related topics