BambooHR is a cloud-based human resources management system (HRMS) that helps businesses manage their employees, payroll, and benefits.
BambooHR is a cloud-based human resources management system (HRMS) that helps businesses manage their employees, payroll, and benefits. On Nagent, BambooHR is exposed as a fully-configurable human resources integration that any agent can call — 41 actions, and OAUTH2, API_KEY authentication. No code is required to wire BambooHR into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use BambooHR to automate the kinds of tasks human resources teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire BambooHR into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against BambooHR, with input parameters and output schema. Drop these into any step of an agent built in Helix.
BAMBOOHR_ATS_CREATE_CANDIDATETool to create a candidate application. Use when adding a new applicant to a specific job opening in BambooHR ATS.
Input parameters
Postal code
City of residence
Candidate's email address
ID of the job opening to apply for
State or province of residence
Resume file.
Source of the application, e.g., 'LinkedIn'
Candidate's street address
Country code (ISO 2-letter format)
Candidate's last name
Candidate's first name
References information
Person who referred the candidate
Candidate's personal website URL
Name of the college or university attended
Cover letter file.
LinkedIn profile URL
Candidate's phone number
Date candidate is available to start (YYYY-MM-DD)
Desired salary (text)
Highest level of education achieved
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_ATS_CREATE_JOB_OPENINGTool to create a new job opening in BambooHR ATS. Use when you need to open a new job for applicants.
Input parameters
Status of the job opening.
Department name for the job opening.
Employee ID of the hiring lead. Use BAMBOOHR_GET_HIRING_LEADS to get valid IDs.
Location ID. Use BAMBOOHR_GET_META_LOCATIONS to get valid IDs.
Compensation range as text.
Title of the job opening.
Employment type. Valid values depend on company configuration, common values: 'Full-Time', 'Part-Time', 'Contractor', 'Intern'. Use BAMBOOHR_GET_META_EMPLOYMENT_STATUSES to get valid values.
Full job description text.
Internal job code reference for tracking purposes.
Minimum experience level.
Resume question requirement: true (optional), false (hidden), required.
Address question requirement: true (optional), false (hidden), required.
College question requirement: true (optional), false (hidden), required.
References question requirement: true (optional), false (hidden), required.
Referred by question requirement: true (optional), false (hidden), required.
Website URL question requirement: true (optional), false (hidden), required.
Cover letter question requirement: true (optional), false (hidden), required.
LinkedIn URL question requirement: true (optional), false (hidden), required.
Date available question requirement: true (optional), false (hidden), required.
Desired salary question requirement: true (optional), false (hidden), required.
Highest education question requirement: true (optional), false (hidden), required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_ATS_GET_APPLICATIONSTool to list job applications with optional filters. Use when retrieving ATS applications for reporting or integration.
Input parameters
Page number for pagination (1-indexed).
Filter by job ID.
Filter by job status groups: 'ALL', 'DRAFT_AND_OPEN', 'Open', 'Filled', 'Draft', 'Deleted', 'On Hold', or 'Canceled'.
Filter by application status name, e.g., 'New', 'Active', 'Inactive', 'Hired'.
Filter by application status ID (e.g., 1 for 'New', 2 for 'Reviewed').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_BENEFIT_GET_COVERAGESTool to retrieve standard benefit coverage options. Use when you need to fetch all or specific coverages before configuring benefit plans.
Input parameters
ID of the benefit coverage to retrieve. If omitted, the API returns all available benefit coverages.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_BENEFIT_GET_MEMBER_EVENTSTool to list member benefit events. Use when you need to fetch all benefit events visible to the authenticated user.
Input parameters
Maximum number of member benefit records to return (non-negative). Returns all if omitted.
Number of member benefit records to skip before returning results (non-negative). Defaults to 0.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_COMPANY_GET_EINSTool to retrieve company Employer Identification Numbers (EINs). Use when you need to fetch your account's EINs after authenticating.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_COMPANY_GET_INFORMATIONTool to retrieve company information. Use when you need details about the current account's settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_CREATE_FILE_CATEGORYTool to create new company file categories. Use when organizing company files by adding new categories after confirming desired names.
Input parameters
A non-empty list of new company file category names.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_CREATE_TIME_OFF_REQUESTTool to submit a new time off request. Use after confirming employee ID and valid payload.
Input parameters
End date of the time off (YYYY-MM-DD).
Optional list of date entries; each should have 'ymd' and 'amount' keys.
Optional list of note objects to attach; each should have 'from' and 'note' keys.
Start date of the time off (YYYY-MM-DD).
Total amount for the request (hours or days). If omitted, BambooHR calculates from dates.
Status of the time off request; usually 'requested'.
BambooHR numeric ID of the employee for whom to create the request.
ID of the time off policy/type to use.
ID of a previous request to reference or adjust.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_DATASETS_LISTTool to list available datasets via the Datasets API. Use when you need to discover available dataset schemas before querying data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_DEPENDENTS_CREATETool to add a dependent to an employee. Use when a new dependent needs to be recorded for benefits or HR tracking. Ensure the employee record exists before calling this tool.
Input parameters
Dependent's Social Security Number (unmasked)
Dependent's city
Dependent's state code (2-character)
Dependent's gender
Dependent's country code (2-character ISO)
Dependent's ZIP or postal code
Dependent's last name
Dependent's first name
Dependent's home phone number
Dependent's student status flag; string value 'true' or 'false'
BambooHR employee ID to which the dependent will be added
Dependent's middle name
Dependent's date of birth in YYYY-MM-DD format
Dependent's US citizenship flag; string value 'true' or 'false'
Dependent's address line 1
Dependent's address line 2
Relationship to the employee; one of spouse, child, domestic partner, step child, foster child
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_DEPENDENTS_GET_ALLTool to retrieve all employee dependents. Use after ensuring your API key has access to benefit settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_EMPLOYEE_CREATETool to create a new employee record. Use when adding employees via BambooHR API. Returns the new employee's ID.
Input parameters
Employee's last name.
Employee's first name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_EMPLOYEE_FILES_CREATE_CATEGORYTool to create new employee file categories. Use when organizing employee files by adding new categories after confirming desired names.
Input parameters
A non-empty list of new employee file category names.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_EMPLOYEE_GET_CHANGEDTool to get employees inserted, updated, or deleted since a given timestamp. Use when fetching incremental HR changes.
Input parameters
Retrieve changes since this timestamp (ISO 8601 format, UTC).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_FILES_LISTTool to list company file categories and their files. Use when you need to retrieve all company files organized by category after confirming file inventory exists.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_FILES_UPLOADTool to upload a new company file. Use when you need to add a file to BambooHR after confirming its category and share settings.
Input parameters
File to upload.
Whether to make the file available to employees (yes or no).
Category ID to place the new file in.
File name to associate with the uploaded file.
Inline file content to upload as bytes or UTF-8 string, used when FileUploadable is not available.
MIME type for the inline content (e.g., 'text/plain', 'application/pdf'). Defaults to application/octet-stream.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_ALL_EMPLOYEESRetrieves all employees from the BambooHR employee directory including their basic information and status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_APPLICANT_STATUSESTool to retrieve applicant statuses. Use when you need to list ATS statuses for your company; requires ATS settings access.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_CUSTOM_EMPLOYEE_FIELDSTool to fetch custom employee field values. Use when you need to retrieve only custom fields for all employees.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_CUSTOM_REPORTSTool to run a custom report by ID or ad-hoc fields. Use when you need to execute a saved report or generate an ad-hoc report and retrieve its results in JSON or file format.
Input parameters
Optional title for the generated report.
List of field keys or aliases to include for an ad-hoc report.
Output format of the report; JSON returns parsed content, others return a file.
ID of a saved custom report to execute.
Whether to include only current employees (true) or all employees (false).
ISO8601 datetime to include employees changed since this timestamp.
Set to 'no' to exclude employees with null lastChanged.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_EMPLOYEETool to retrieve detailed information for a specific employee. Use when you need individual employee data by ID.
Input parameters
Optional list of field keys to include in the response. If omitted, returns default set of fields.
The ID of the employee to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_EMPLOYEE_PHOTOTool to retrieve an employee's profile photo by size. Use when you need to download the image binary for the specified employee after confirming their ID.
Input parameters
Size of the employee photo to retrieve
BambooHR employee ID whose photo is to be fetched
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_HIRING_LEADSTool to retrieve potential hiring leads (employees who can manage job openings) for use in creating a new job opening. The API key owner must have access to ATS settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_JOB_SUMMARIESTool to retrieve a list of ATS job summaries. Use when you need an overview of all job postings and their key details.
Input parameters
Field to sort by. Possible values: created, status, title
Sort order, either ASC or DESC
Filter jobs by status group. Possible values: ALL, DRAFT_AND_OPEN, DRAFT, OPEN, CLOSED
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_META_DEPARTMENTSTool to list department metadata. Use after needing all available department codes and names.
Input parameters
Maximum number of results to return (non-negative)
Number of results to skip before returning items (non-negative)
Case-insensitive substring that the department name must contain
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_META_DIVISIONSTool to list all division metadata. Use after authenticating to fetch the account's divisions.
Input parameters
Maximum number of results to return (non-negative)
Number of results to skip before returning items (non-negative)
Case-insensitive substring that the division name must contain
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_META_EMPLOYMENT_STATUSESTool to list all employment status metadata. Use when you need all defined employment statuses for the company.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_META_JOB_TITLESTool to retrieve job title metadata. Uses the list-field metadata endpoint and extracts the options for the `jobTitle` field.
Input parameters
Maximum number of results to return (non-negative)
Number of results to skip before returning items (non-negative)
Case-insensitive substring that the job title name must contain
When false, exclude archived job titles from results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_META_LOCATIONSTool to list location metadata. Use when you need all configured company locations for lookups.
Input parameters
Maximum number of results to return (non-negative)
Number of results to skip before returning items (non-negative)
Case-insensitive substring that the location name must contain
When false, exclude archived locations from results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_META_TIME_OFF_TYPESTool to list time-off type metadata. Use when you need to discover available time-off types before creating time-off requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_REPORTTool to fetch a built-in or published report in JSON or other formats. Use when you need to retrieve report data or download report files after specifying the report ID and desired output format.
Input parameters
Apply duplicate field filtering: 'yes' or 'no'
Output format of the report
ID of the report to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_TIME_OFF_BALANCESTool to retrieve time-off balances for employees. Use when you need current balances across your team.
Input parameters
End date (YYYY-MM-DD) to estimate balances as of.
Optional list of employee IDs to filter balances for.
Maximum number of employees to fetch balances for. Limits API calls to avoid timeouts.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_GET_TIME_OFF_REQUESTSTool to list time-off requests within a date range. Use after confirming start and end dates; supports optional filters for status, employee, and time off type.
Input parameters
Limit results to a specific request ID
Only show time off on or before this date, format YYYY-MM-DD
Comma-separated list of time off type IDs to include
Only show time off on or after this date, format YYYY-MM-DD
Filter by access level; legal values: view, approve
Comma-separated list of request statuses; legal values: approved, denied, superseded, requested, canceled
Limit results to a specific employee ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_LIST_BUILTIN_REPORTSTool to list all available company and custom reports. Use after confirming account setup. Requires 'report' scope for OAuth or an API key with report access permissions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_META_GET_COUNTRIESTool to retrieve all available country options. Use when you need a complete list of selectable countries before updating or validating country fields.
Input parameters
Maximum number of results to return (non-negative)
Number of results to skip before returning items (non-negative)
Case-insensitive substring that the country name must contain
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_META_GET_LIST_FIELD_DETAILSTool to get details for all list fields. Use when you need to discover list field options before using them.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_META_GET_TABULAR_FIELDSTool to list tabular table fields metadata. Use when you need standard table structures before accessing table rows.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_META_GET_USERSTool to list active users with basic info. Use when you need to retrieve current users' IDs, names, and emails.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_UPDATE_EMPLOYEETool to update fields on a specified employee record. Use when you need to modify employee properties via BambooHR API after confirming the target employee ID. Example: "Update employee 12345's department to Sales".
Input parameters
Key/value pairs of employee fields to update, using BambooHR API field names.
The BambooHR employee ID to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BAMBOOHR_UPDATE_TIME_OFF_REQUESTTool to update the status of an existing time-off request. Use when you need to approve, deny, or cancel a request after reviewing it. Example: "Approve time-off request 12345".
Input parameters
Optional note to include with the status change
New status for the time-off request
ID of the time-off request to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 82 agents privately built on Nagent that already use BambooHR.
Build on Nagent
Connect BambooHR to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find BambooHR, and click "Connect Now." You'll authenticate with OAUTH2, API_KEY — Nagent handles credential storage and refresh automatically. Once connected, BambooHR is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once BambooHR is connected, you configure its 41 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop BambooHR steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a BambooHR event fires, the agent kicks off automatically.
Every BambooHR action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While BambooHR ships with 41 pre-built human resources actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching BambooHR together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build BambooHR-based workflows tailored to your business.