View as Markdown
BambooHR icon

BambooHR ACTION

Create Hour Record

Add a single approved hour record to the legacy Hours API, separate from Time Tracking timesheets — use Create Hour Entry instead for timesheet-integrated hours. You choose the record's ID; save it to update or delete this record later with Update Hour Record / Delete Hour Record. 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 Create 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-create-hour-record",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    bamboohr: { authProvisionId: "apn_xxxxxxx" },
    recordId: "Record ID",
    employeeId: "Employee ID",
  },
})

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.

Create Hour Record inputs
Property Type Description
recordId Record ID string
A unique ID you choose for this record (up to 36 characters), e.g. 550e8400-e29b-41d4-a716-446655440000 (a UUID). Save it — you'll need it to update or delete this record later.
Required
employeeId Employee ID string
The employee ID (e.g. 100). Run Get Employees Directory to discover IDs.
Required
dateHoursWorked Date Hours Worked string
The date the hours were worked, in YYYY-MM-DD format, e.g. 2026-09-01.
Required
hoursWorked Hours Worked string
Number of hours worked as a decimal, e.g. 8 or 7.5.
Required
rateType Rate Type string
The type of hours worked.
Required
divisionId Division ID string
Optional numeric division ID, e.g. 1. Company-specific; find valid IDs in your BambooHR payroll/company settings.
Optional
departmentId Department ID string
Optional numeric department ID, e.g. 2. Company-specific; find valid IDs in your BambooHR payroll/company settings.
Optional
jobTitleId Job Title ID string
Optional numeric job title ID, e.g. 3. Company-specific; find valid IDs in your BambooHR payroll/company settings.
Optional
payCode Pay Code string
Optional pay code; required by some payroll providers, e.g. REG1. Company-specific; check with your payroll provider or BambooHR admin.
Optional
payRate Pay Rate string
Optional hourly pay rate as a decimal, e.g. 15.00.
Optional
jobCode Job Code string
Optional numeric job code, e.g. 100. Company-specific; find valid codes in your BambooHR payroll/company settings.
Optional
jobData Job Data string
Up to four 20-character job numbers, comma-delimited, e.g. JOB1,JOB2.
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-create-hour-record
Version
0.0.1
App
BambooHR
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes