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

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