View as Markdown
BambooHR icon

BambooHR ACTION

Update Hour Record

Edit an existing legacy Hours API record's hours worked and links. Send the corrected total hours worked, not a delta. Use Get Time Tracking Record to check current values first. 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 Hour Record 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-hour-record",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    bamboohr: { authProvisionId: "apn_xxxxxxx" },
    recordId: "Record ID",
    hoursWorked: "Hours Worked",
  },
})

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 Hour Record inputs
Property Type Description
recordId Record ID string
The ID of the hour record to update, e.g. 550e8400-e29b-41d4-a716-446655440000 (the UUID you supplied in Create Hour Record). Run Get Time Tracking Record to check its current values, or use the ID you supplied in Create Hour Record.
Required
hoursWorked Hours Worked string
The corrected total number of hours worked (not a delta) — e.g. send 6.0 if the employee actually worked 6 hours instead of the original 8.
Required
projectId Project ID string
Optional numeric project ID, e.g. 19. Find valid IDs in your BambooHR time tracking project settings.
Optional
taskId Task ID string
Optional numeric task ID within the project, e.g. 47 (requires projectId). Find valid IDs in your BambooHR time tracking project settings.
Optional
shiftDifferentialId Shift Differential ID string
Optional numeric shift differential ID to associate with the record, e.g. 1. Company-specific; find valid IDs in your BambooHR payroll/company settings.
Optional
holidayId Holiday ID string
Optional numeric holiday ID to associate with the record, e.g. 1. Company-specific (legacy Hours API); find valid IDs in your BambooHR payroll/company settings.
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-hour-record
Version
0.0.1
App
BambooHR
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes