View as Markdown
BambooHR icon

BambooHR ACTION

Update Employee

Update fields on an existing employee. Only supplied fields are changed; unknown field names are silently ignored. Use Get Employees Directory to find the employee ID. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's BambooHR account once, then configure and run Update Employee from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "bamboohr-update-employee",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    bamboohr: { authProvisionId: "apn_xxxxxxx" },
    employeeId: "Employee ID",
    firstName: "First Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Employee inputs
Property Type Description
employeeId Employee ID string
The employee ID to update (e.g. 100). Run Get Employees Directory to discover IDs.
Required
firstName First Name string
First name.
Optional
lastName Last Name string
Last name.
Optional
workEmail Work Email string
Work email address.
Optional
jobTitle Job Title string
Job title.
Optional
department Department string
Department name.
Optional
division Division string
Division name.
Optional
location Location string
Location name.
Optional
hireDate Hire Date string
Hire date in YYYY-MM-DD format, e.g. 2026-01-31.
Optional
additionalFields Additional Fields object
Additional writable fields as name-value pairs, e.g. {"mobilePhone":"555-1234","address1":"1 Main St"}. Unrecognized names are silently ignored, so use the exact field names/aliases listed in BambooHR's Field Names reference.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
bamboohr-update-employee
Version
0.0.1
App
BambooHR
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes