BambooHR

Tools (42)

• Create Candidate Application

  Tool to create a candidate application. Use when adding a new applicant to a specific job opening in BambooHR ATS.

  Inputs: zip, city, email, jobId, state, resume, source, address, country, lastName, firstName, references, referredBy, websiteUrl, collegeName, coverLetter, linkedinUrl, phoneNumber, dateAvailable, desiredSalary, highestEducation

• Create Job Opening

  Tool to create a new job opening in BambooHR ATS. Use when you need to open a new job for applicants.

  Inputs: jobStatus, department, hiringLead, jobLocation, compensation, postingTitle, employmentType, jobDescription, internalJobCode, minimumExperience, applicationQuestionResume, applicationQuestionAddress, applicationQuestionCollege, applicationQuestionReferences, applicationQuestionReferredBy, applicationQuestionWebsiteUrl, applicationQuestionCoverLetter, applicationQuestionLinkedinUrl, applicationQuestionDateAvailable, applicationQuestionDesiredSalary, applicationQuestionHighestEducation

• List Job Applications

  Tool to list job applications with optional filters. Use when retrieving ATS applications for reporting or integration.

  Inputs: page, jobId, jobStatusGroups, applicationStatus, applicationStatusId

• Get Benefit Coverages

  Tool to retrieve standard benefit coverage options. Use when you need to fetch all or specific coverages before configuring benefit plans.

  Inputs: coverage_id

• Get Member Benefit Events

  Tool to list member benefit events. Use when you need to fetch all benefit events visible to the authenticated user.

  Inputs: limit, offset

• Get Company EINs

  Tool to retrieve company Employer Identification Numbers (EINs). Use when you need to fetch your account's EINs after authenticating.

• Get Company Information

  Tool to retrieve company information. Use when you need details about the current account's settings.

• Create File Category

  Tool to create new company file categories. Use when organizing company files by adding new categories after confirming desired names.

  Inputs: categories

• Create Time Off Request

  Tool to submit a new time off request. Use after confirming employee ID and valid payload.

  Inputs: end, dates, notes, start, amount, status, employeeId, timeOffTypeId, previousRequest

• List Datasets

  Tool to list available datasets via the Datasets API. Use when you need to discover available dataset schemas before querying data.

• Create Employee Dependent

  Tool 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.

  Inputs: ssn, city, state, gender, country, zipCode, lastName, firstName, homePhone, isStudent, employeeId, middleName, dateOfBirth, isUsCitizen, addressLine1, addressLine2, relationship

• Get All Employee Dependents

  Tool to retrieve all employee dependents. Use after ensuring your API key has access to benefit settings.

• Create Employee

  Tool to create a new employee record. Use when adding employees via BambooHR API. Returns the new employee's ID.

  Inputs: lastName, firstName

• Create Employee File Category

  Tool to create new employee file categories. Use when organizing employee files by adding new categories after confirming desired names.

  Inputs: categories

• Get Changed Employees

  Tool to get employees inserted, updated, or deleted since a given timestamp. Use when fetching incremental HR changes.

  Inputs: since

• List Company Files

  Tool 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.

• Upload Company File

  Tool to upload a new company file. Use when you need to add a file to BambooHR after confirming its category and share settings.

  Inputs: file, share, category, fileName, rawContent, rawMimetype

• Get All Employees

  Retrieves all employees from the BambooHR employee directory including their basic information and status.

• Get Applicant Statuses

  Tool to retrieve applicant statuses. Use when you need to list ATS statuses for your company; requires ATS settings access.

• Get Custom Employee Fields

  Tool to fetch custom employee field values. Use when you need to retrieve only custom fields for all employees.

• Run Custom Report

  Tool 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.

  Inputs: title, fields, format, reportId, onlyCurrent, filters_last_changed_value, filters_last_changed_include_null

• Get Employee

  Tool to retrieve detailed information for a specific employee. Use when you need individual employee data by ID.

  Inputs: fields, employeeId

• Get Employee Photo

  Tool 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.

  Inputs: size, employee_id

• Get Hiring Leads

  Tool 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.

• Get Job Summaries

  Tool to retrieve a list of ATS job summaries. Use when you need an overview of all job postings and their key details.

  Inputs: sortBy, sortOrder, statusGroups

• Get Departments Metadata

  Tool to list department metadata. Use after needing all available department codes and names.

  Inputs: limit, offset, name_contains

• Get Meta Divisions

  Tool to list all division metadata. Use after authenticating to fetch the account's divisions.

  Inputs: limit, offset, name_contains

• List Employment Status Metadata

  Tool to list all employment status metadata. Use when you need all defined employment statuses for the company.

• Get Meta Job Titles

  Tool to retrieve job title metadata. Uses the list-field metadata endpoint and extracts the options for the `jobTitle` field.

  Inputs: limit, offset, name_contains, include_archived

• Get Meta Locations

  Tool to list location metadata. Use when you need all configured company locations for lookups.

  Inputs: limit, offset, name_contains, include_archived

• Get Time-Off Types Metadata

  Tool to list time-off type metadata. Use when you need to discover available time-off types before creating time-off requests.

• Get Report

  Tool 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.

  Inputs: fd, format, report_id

• Get Time-Off Balances

  Tool to retrieve time-off balances for employees. Use when you need current balances across your team.

  Inputs: end_date, employee_ids, max_employees

• Get Time-Off Policies

  Tool to list time-off policies with accrual rates and details. This action retrieves policy configuration including accrual amounts, schedules, maximum accrual limits, and rollover settings. Use this action when you need to understand how time-off accrues for employees, distinct from checking current balances.

• Get Time-Off Requests

  Tool 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.

  Inputs: id, end, type, start, action, status, employeeId

• List Company Reports

  Tool 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.

• Get Country Options

  Tool to retrieve all available country options. Use when you need a complete list of selectable countries before updating or validating country fields.

  Inputs: limit, offset, name_contains

• Get List Field Details

  Tool to get details for all list fields. Use when you need to discover list field options before using them.

• Get Tabular Fields Metadata

  Tool to list tabular table fields metadata. Use when you need standard table structures before accessing table rows.

• Get Users

  Tool to list active users with basic info. Use when you need to retrieve current users' IDs, names, and emails.

• Update Employee

  Tool 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".

  Inputs: fields, employee_id

• Update Time Off Request

  Tool 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".

  Inputs: note, status, request_id