# BambooHR BambooHR is a cloud-based human resources management system (HRMS) that helps businesses manage their employees, payroll, and benefits. - **Category:** human resources - **Auth:** OAUTH2, API_KEY - **Composio Managed App Available?** No - **Tools:** 41 - **Triggers:** 0 - **Slug:** `BAMBOOHR` - **Version:** 20260429_00 ## Tools ### Create Candidate Application **Slug:** `BAMBOOHR_ATS_CREATE_CANDIDATE` Tool to create a candidate application. Use when adding a new applicant to a specific job opening in BambooHR ATS. ### Create Job Opening **Slug:** `BAMBOOHR_ATS_CREATE_JOB_OPENING` Tool to create a new job opening in BambooHR ATS. Use when you need to open a new job for applicants. ### List Job Applications **Slug:** `BAMBOOHR_ATS_GET_APPLICATIONS` Tool to list job applications with optional filters. Use when retrieving ATS applications for reporting or integration. ### Get Benefit Coverages **Slug:** `BAMBOOHR_BENEFIT_GET_COVERAGES` Tool to retrieve standard benefit coverage options. Use when you need to fetch all or specific coverages before configuring benefit plans. ### Get Member Benefit Events **Slug:** `BAMBOOHR_BENEFIT_GET_MEMBER_EVENTS` Tool to list member benefit events. Use when you need to fetch all benefit events visible to the authenticated user. ### Get Company EINs **Slug:** `BAMBOOHR_COMPANY_GET_EINS` Tool to retrieve company Employer Identification Numbers (EINs). Use when you need to fetch your account's EINs after authenticating. ### Get Company Information **Slug:** `BAMBOOHR_COMPANY_GET_INFORMATION` Tool to retrieve company information. Use when you need details about the current account's settings. ### Create File Category **Slug:** `BAMBOOHR_CREATE_FILE_CATEGORY` Tool to create new company file categories. Use when organizing company files by adding new categories after confirming desired names. ### Create Time Off Request **Slug:** `BAMBOOHR_CREATE_TIME_OFF_REQUEST` Tool to submit a new time off request. Use after confirming employee ID and valid payload. ### List Datasets **Slug:** `BAMBOOHR_DATASETS_LIST` Tool to list available datasets via the Datasets API. Use when you need to discover available dataset schemas before querying data. ### Create Employee Dependent **Slug:** `BAMBOOHR_DEPENDENTS_CREATE` 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. ### Get All Employee Dependents **Slug:** `BAMBOOHR_DEPENDENTS_GET_ALL` Tool to retrieve all employee dependents. Use after ensuring your API key has access to benefit settings. ### Create Employee **Slug:** `BAMBOOHR_EMPLOYEE_CREATE` Tool to create a new employee record. Use when adding employees via BambooHR API. Returns the new employee's ID. ### Create Employee File Category **Slug:** `BAMBOOHR_EMPLOYEE_FILES_CREATE_CATEGORY` Tool to create new employee file categories. Use when organizing employee files by adding new categories after confirming desired names. ### Get Changed Employees **Slug:** `BAMBOOHR_EMPLOYEE_GET_CHANGED` Tool to get employees inserted, updated, or deleted since a given timestamp. Use when fetching incremental HR changes. ### List Company Files **Slug:** `BAMBOOHR_FILES_LIST` 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 **Slug:** `BAMBOOHR_FILES_UPLOAD` Tool to upload a new company file. Use when you need to add a file to BambooHR after confirming its category and share settings. ### Get All Employees **Slug:** `BAMBOOHR_GET_ALL_EMPLOYEES` Retrieves all employees from the BambooHR employee directory including their basic information and status. ### Get Applicant Statuses **Slug:** `BAMBOOHR_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 **Slug:** `BAMBOOHR_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 **Slug:** `BAMBOOHR_GET_CUSTOM_REPORTS` 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. ### Get Employee **Slug:** `BAMBOOHR_GET_EMPLOYEE` Tool to retrieve detailed information for a specific employee. Use when you need individual employee data by ID. ### Get Employee Photo **Slug:** `BAMBOOHR_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. ### Get Hiring Leads **Slug:** `BAMBOOHR_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 **Slug:** `BAMBOOHR_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. ### Get Departments Metadata **Slug:** `BAMBOOHR_GET_META_DEPARTMENTS` Tool to list department metadata. Use after needing all available department codes and names. ### Get Meta Divisions **Slug:** `BAMBOOHR_GET_META_DIVISIONS` Tool to list all division metadata. Use after authenticating to fetch the account's divisions. ### List Employment Status Metadata **Slug:** `BAMBOOHR_GET_META_EMPLOYMENT_STATUSES` Tool to list all employment status metadata. Use when you need all defined employment statuses for the company. ### Get Meta Job Titles **Slug:** `BAMBOOHR_GET_META_JOB_TITLES` Tool to retrieve job title metadata. Uses the list-field metadata endpoint and extracts the options for the `jobTitle` field. ### Get Meta Locations **Slug:** `BAMBOOHR_GET_META_LOCATIONS` Tool to list location metadata. Use when you need all configured company locations for lookups. ### Get Time-Off Types Metadata **Slug:** `BAMBOOHR_GET_META_TIME_OFF_TYPES` Tool to list time-off type metadata. Use when you need to discover available time-off types before creating time-off requests. ### Get Report **Slug:** `BAMBOOHR_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. ### Get Time-Off Balances **Slug:** `BAMBOOHR_GET_TIME_OFF_BALANCES` Tool to retrieve time-off balances for employees. Use when you need current balances across your team. ### Get Time-Off Requests **Slug:** `BAMBOOHR_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. ### List Company Reports **Slug:** `BAMBOOHR_LIST_BUILTIN_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 **Slug:** `BAMBOOHR_META_GET_COUNTRIES` Tool to retrieve all available country options. Use when you need a complete list of selectable countries before updating or validating country fields. ### Get List Field Details **Slug:** `BAMBOOHR_META_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 **Slug:** `BAMBOOHR_META_GET_TABULAR_FIELDS` Tool to list tabular table fields metadata. Use when you need standard table structures before accessing table rows. ### Get Users **Slug:** `BAMBOOHR_META_GET_USERS` Tool to list active users with basic info. Use when you need to retrieve current users' IDs, names, and emails. ### Update Employee **Slug:** `BAMBOOHR_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". ### Update Time Off Request **Slug:** `BAMBOOHR_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".