View as Markdown
BambooHR icon

BambooHR ACTION

Get Employee

Get a single employee record. Only id is returned unless you request fields. Use Get Employees Directory to find an employee ID. Pass 0 as the ID to fetch the authenticated user. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's BambooHR account once, then configure and run Get 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-get-employee",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    bamboohr: { authProvisionId: "apn_xxxxxxx" },
    employeeId: "Employee ID",
    fields: "Fields",
  },
})

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.

Get Employee inputs
Property Type Description
employeeId Employee ID string
The employee ID (e.g. 100). Use 0 for the authenticated user. Run Get Employees Directory to discover IDs.
Required
fields Fields string
Comma-separated field names/IDs/aliases to return (max 400), e.g. firstName,lastName,department,workEmail. Unauthorized fields are silently omitted.
Optional
onlyCurrent Only Current boolean
When true, restricts to the employee's current values.
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-get-employee
Version
0.0.1
App
BambooHR
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes