BambooHR MCP connector

• List List all BambooHR employees Get employee directory for companyDomain in BambooHR. Returns employee id, displayName, firstName, lastName, gender, jobTitle, workPhone, workPhoneExtension, skypeUsername, and facebook fields. Note: Directory feature may be disabled by company.
• Get Get single BambooHR employee by ID Get employee data by specifying id and fields in BambooHR. Returns id, firstName, lastName, and other requested fields.
• Update Update a BambooHR employee by ID Update an employee by id in BambooHR. Requires company_domain and id. Returns success message on update. If employee syncs with Trax Payroll, all specified fields must be included for successful update.
• Create Create a BambooHR employee Add a new employee in BambooHR with required fields firstName and lastName. Returns the Location header containing the URL with the new employee's id.
• Delete Delete a BambooHR employee by ID Permanently delete an employee and all associated data in BambooHR by id. Returns an empty 204 response on success. Required: id (the internal employee ID — do not pass the editable employeeNumber, which may fail with 404 or target the wrong employee).
• List List all BambooHR users Get a list of users for the companyDomain in BambooHR. Returns user id, employeeId if linked, firstName, lastName, email, status, and lastLogin in ISO 8601 format.
• List List all BambooHR time off requests Get time off requests for companyDomain with required start and end dates. Returns id, employeeId, name, status (lastChanged, lastChangedByUserId, status), start, end, created, type (id, name, icon), amount (unit, amount), notes, and dates if available in BambooHR.
• Create Create a BambooHR time off request Create a time off request for employee with id in BambooHR. Requires company_domain and employee id. Returns empty response with 201 status on success. Request includes status, start, end, timeOffTypeId, amount, notes, dates, and previousRequest.
• List List all BambooHR time off balance Get estimated future time off balances for employee id in BambooHR with required company_domain and end date. Returns timeOffType, name, units, balance, policyType, usedYearToDate, and end date fields.
• List List all BambooHR jobs Get a list of job summaries in BambooHR for the specified companyDomain. Returns job details including title, lead, created date, and status.
• Create Create a BambooHR job Add a new job opening in BambooHR with required parameters company_domain, postingTitle, jobStatus, hiringLead, employmentType, and jobDescription. Returns success status on creation.
• Get Get single BambooHR job by ID Retrieves detailed information about a specific job posting in BambooHR based on the unique job ID.
• List List all BambooHR applications Get a list of applications for companyDomain in BambooHR. Returns application id, appliedDate, status with rating, applicant info, and job info. Requires companyDomain.
• Get Get single BambooHR application by ID Get details about a specific application in BambooHR. Requires company_domain and id. Returns fields such as id, appliedDate, status, rating, education, resumeFileId, coverLetterFileId, applicant details, job details, and related counts.
• Action BambooHR applications change status Change applicant's status by application id in BambooHR. Requires companyDomain and applicationId. Returns success status on update.
• Create Create a BambooHR application Add a new candidate application to a job opening in BambooHR. Requires company_domain and jobId. Returns success status on completion.
• List List all BambooHR statuses Get a list of statuses for a company in BambooHR using company_domain. Returns all available status entries for applicant tracking.
• List List all BambooHR company locations Get company locations using company_domain in BambooHR. Returns an array of location objects for creating new job openings.
• List List all BambooHR fields Get a list of fields available in a BambooHR account using companyDomain. Returns id, name, type, and alias for each field.
• Update Update a BambooHR field by ID Use this endpoint to update one or more metadata fields in the account.
• Create Create a BambooHR custom report Request a custom report in BambooHR with companyDomain and format. Returns the report with specified fields such as firstName and lastName. Supports filtering by lastChanged date to include only employees changed since that time.
• List List all BambooHR company files List company files and categories for companyDomain in BambooHR. Returns categories with id and name, and files with id, name, originalFileName, size, dateCreated, createdBy, and shareWithEmployee fields.
• Download BambooHR company files download Use this endpoint to download a specific file stored in the company's BambooHR file repository by providing the file_id.
• Get Get single BambooHR company file by ID Get company file by id in BambooHR using company_domain and id. Returns the file content if found.
• Create Create a BambooHR company file Add a new company file category in BambooHR using company_domain. Returns 201 status on successful creation.
• Update Update a BambooHR company file by ID Update a company file in BambooHR using company_domain and id. Returns status 200 if the file is updated. Fields updated can include name, categoryId, and shareWithEmployees.
• Delete Delete a BambooHR company file by ID Delete a company file by id in BambooHR. Requires company_domain and id. Returns 200 on successful deletion, 403 if permission denied, and 404 if file not found.
• List List all BambooHR employee files List employee files and categories for employee with id in BambooHR. Returns categories with id and name, and files with id, name, originalFileName, size, dateCreated, createdBy, and shareWithEmployee fields.
• Get Get single BambooHR employee file by ID Get an employee file by id and file_id in BambooHR. Returns the file content if found. Requires company_domain, id, and file_id.
• Create Create a BambooHR employee file Add an employee file category in BambooHR using company_domain. Returns 201 status on successful creation.
• Update Update a BambooHR employee file by ID Update an employee file by id in BambooHR with parameters name, categoryId, and shareWithEmployee. Returns status 200 if the file was updated successfully.
• Delete Delete a BambooHR employee file by ID Delete an employee file by employee id and fileId in BambooHR. Returns confirmation of deletion.
• List List all BambooHR payroll deductions Use this endpoint to retrieve a list of payroll deductions assigned to a specific employee, identified by their employee_id
• List List all BambooHR time off types Get a list of time off types for companyDomain in BambooHR. Returns id, name, units, color, and icon for each time off type.
• List List all BambooHR time off policies Get a list of time off policies for the companyDomain in BambooHR. Returns id, timeOffTypeId, name, effectiveDate, and type for each policy.
• List List all BambooHR employee time off policies List time off policies for an employee in BambooHR. Requires company_domain and id. Returns timeOffPolicyId, timeOffTypeId, and accrualStartDate for each policy.
• List List all BambooHR timesheet Get all timesheet entries for a given period with start and end dates in BambooHR. Returns id, employeeId, type, date, start, end, timezone, hours, note, projectInfo, approvedAt, and approved fields. Data limited to last 365 days.
• Create Create a BambooHR clock entry Create a timesheet clock-in entry for an employee in BambooHR. Requires company_domain and id. Returns id, employeeId, type, date, start, end, timezone, hours, note, and projectInfo with project and task details.
• Update Update a BambooHR clock entry by ID Add or edit timesheet clock entries in BambooHR with required entries including employeeId, date, start, and end. Returns id, employeeId, type, date, start, end, timezone, hours, note, and projectInfo fields for each entry.
• Delete Delete a BambooHR clock entry by ID Delete timesheet clock entries by providing clockEntryIds in BambooHR. Returns 204 on successful deletion with no content.
• Action BambooHR clock entries clock out Create a timesheet clock-out entry for an employee in BambooHR using company_domain and id. Returns id, employeeId, type, date, start, end, timezone, hours, note, and projectInfo fields.
• Update Update a BambooHR hour entry by ID Add or edit timesheet hour entries in BambooHR. Requires companyDomain and an array of hours objects with employeeId, date, hours, note, projectId, and taskId. Returns id, employeeId, type, date, hours, note, and projectInfo with project and task details.
• Delete Delete a BambooHR hour entry by ID Delete timesheet hour entries in BambooHR using companyDomain and hourEntryIds. Returns no content on success.
• List List all BambooHR webhooks Get a list of webhooks for the user API key in BambooHR. Requires company_domain. Returns webhook id, name, created date, lastSent date, and url.
• Get Get single BambooHR webhook by ID Get webhook data for a specific webhook by id in BambooHR. Returns id, name, created timestamp, lastSent timestamp, monitorFields, postFields, url, format, frequency, limit, and includeCompanyDomain fields.
• Create Create a BambooHR webhook Create a new webhook in BambooHR with required parameters company_domain, name, monitorFields, postFields, and url. Returns webhook id, name, created timestamp, lastSent timestamp, monitorFields, postFields, url, format, frequency, limit, privateKey, and includeCompanyDomain flag.
• Update Update a BambooHR webhook by ID Update a webhook by id in BambooHR with required fields name, monitorFields, postFields, and url. Returns updated webhook id, name, created timestamp, lastSent timestamp, monitorFields, postFields, url, format, frequency, limit, and includeCompanyDomain.
• Delete Delete a BambooHR webhook by ID Delete a webhook by id for the specified companyDomain in BambooHR. Returns confirmation of deletion.
• Action BambooHR webhooks logs Get webhook logs for a specific webhook by id in BambooHR. Returns webhookId, url, lastAttempted, lastSuccess, failureCount, status, and employeeIds fields.
• Action BambooHR webhooks fields Get a list of fields that webhooks can monitor in BambooHR. Requires company_domain. Returns fields with id, name, and alias.
• List List all BambooHR dataset Get available datasets for the companyDomain in BambooHR. Returns dataset name and label fields.
• Action BambooHR dataset fields Get available fields for a dataset in BambooHR using companyDomain and datasetName. Returns fields with name, label, parentType, and parentName.
• Action BambooHR dataset data Query a BambooHR dataset (for example employee) and return its rows. Choose the fields to return, filter with typed operators (contains, equal, lt, gte, last, next, range, includes …) combined by match all or any, sort, group by one field, aggregate (count, count_unique, sum, avg, min, max), and include history rows for historical table fields with showHistory. Use dataset.list and dataset.fields to discover dataset and field names. Returns data (rows keyed by field name, or an object keyed by group value when groupBy is used), aggregations, and pagination. Results are paged with page and page_size (default 500, maximum 1000). Required: dataset_name and fields.
• List List all BambooHR employee dependents Get all employee dependents for employeeid in BambooHR. Returns id, employeeId, firstName, lastName, relationship, gender, maskedSSN, dateOfBirth, address, city, state, zipCode, country, isUsCitizen, and isStudent fields.
• Get Get single BambooHR employee dependent by ID Get employee dependent by id in BambooHR. Returns fields including id, employeeId, firstName, lastName, relationship, gender, maskedSSN, dateOfBirth, address, city, state, zipCode, country, isUsCitizen, and isStudent.
• Create Create a BambooHR employee dependent Add an employee dependent in BambooHR with employeeId, firstName, lastName, relationship, gender, ssn, dateOfBirth, addressLine1, city, state, zipCode, country, isUsCitizen, and isStudent. Date of birth must be in ISO YYYY-MM-DD format. Gender must be male or female. Relationship must be spouse, child, domestic partner, step child, or foster child. State must be 2 character code. Country must be 2 character ISO code.
• Update Update a BambooHR employee dependent by ID Update an employee dependent by id in BambooHR. Requires company_domain and id. Returns status 201 on success.
• List List all BambooHR benefits Get benefit coverages for the companyDomain in BambooHR. Returns id, shortName, description, and sortOrder for each benefit coverage.
• Action BambooHR benefits deduction type Get all benefit deduction types for the companyDomain in BambooHR. Returns id, deductionTypeName, and allowableBenefitTypes for each deduction type.
• Action BambooHR benefits member events Get a list of member benefit events in BambooHR for the specified companyDomain. Returns members with memberId, coverages with planId, and events including effectiveDate, type, premiumTierId, and monthlyPremiumInCents.
• List List all BambooHR company information Get company information for companyDomain in BambooHR. Returns legalName, displayName, address (line1, line2, city, state, zip), and phone number.
• List List all BambooHR company eins Get Company EINs for the companyDomain in BambooHR. Returns an array of EIN strings representing the company's Employer Identification Numbers.
• List List all BambooHR table Get all updated employee table data for table using companyDomain and table. Returns employees with changes since the provided 'since' timestamp including employee id, lastChanged timestamp, and all table rows with fields.
• Get Get single BambooHR table by ID Get all table rows for a given employee and table in BambooHR. Requires company_domain, id (employee ID), and table name. Returns rows with fields like date, location, division, department, jobTitle, and reportsTo.
• Create Create a BambooHR table Add a table row for an employee in BambooHR using company_domain, id, and table. Returns success message if row is added. Requires all required fields for the table and employee if on compensation table.
• Update Update a BambooHR table by ID Update a table row for an employee in BambooHR using company_domain, id, table, and row_id. Returns 200 if at least one field is updated. Requires all required fields for pay schedule or compensation table if applicable.
• Delete Delete a BambooHR table by ID Delete a table row for an employee in BambooHR. Requires employee id, table name, and rowId.
• List List all BambooHR goals Get goals for an employee in BambooHR using company_domain and employee_id. Returns id, title, description, percentComplete, dueDate, completionDate, status, milestones, and actions for each goal.
• Create Create a BambooHR goal Create a new goal for an employee in BambooHR using company_domain and employee id. Returns the goal id, title, description, percentComplete, sharedWithEmployeeIds, dueDate, completionDate, status, and milestones if included.
• Delete Delete a BambooHR goal by ID Delete a goal for an employee in BambooHR using company_domain, employee_id, and id. Returns 204 on successful deletion.
• Update Update a BambooHR goal by ID Update a goal for employeeId and id in BambooHR. Requires title, sharedWithEmployeeIds, dueDate. Returns updated goal fields including id, title, description, percentComplete, sharedWithEmployeeIds, dueDate, completionDate, status, and milestones if enabled.
• List List all BambooHR goal comments Get comments for a specific goal using employee_id and goal_id in BambooHR. Returns comment id, authorUserId, createdAt, text, canEdit, and canDelete fields.
• Create Create a BambooHR goal comment Create a new goal comment for employeeId and goalId in BambooHR. Returns id, authorUserId, createdAt, text, canEdit, and canDelete fields in the response.
• Update Update a BambooHR goal comment by ID Update a goal comment for employeeId, goalId, and commentId in BambooHR. Returns id, authorUserId, createdAt, text, canEdit, and canDelete fields in the response.
• Delete Delete a BambooHR goal comment by ID Delete a goal comment for employee_id, goal_id, and comment_id in BambooHR. Returns 204 No Content on success.
• Get Get single BambooHR photo by ID Get an employee photo in BambooHR using company_domain, employee id, and size. Returns binary JPEG data of the photo in specified size (original, large, medium, small, xs, tiny).
• Create Create a BambooHR photo Store a new employee photo for employeeId in BambooHR. The photo must be jpg, gif, or png, have equal width and height, and be no larger than 20MB. Returns 201 on success.
• Get Get single BambooHR time tracking by ID Get an hour record by id in BambooHR. Returns fields including timeTrackingId, employeeId, dateHoursWorked, hoursWorked, adjustedHours, payRate, and job details.
• Create Create a BambooHR time tracking Add a time tracking record in BambooHR with required parameters companyDomain, timeTrackingId, employeeId, dateHoursWorked, rateType, and hoursWorked. Returns timeTrackingId of the created record.
• Update Update a BambooHR time tracking by ID Edit an hour record in BambooHR using timeTrackingId and hoursWorked. Returns the updated timeTrackingId.
• Delete Delete a BambooHR time tracking by ID Delete an hour record in BambooHR using companyDomain and id. Returns status and message confirming record removal.
• Action BambooHR login user Authenticate user login in BambooHR using companyDomain, user email, password, and applicationKey. Returns success status, userId, employeeId, and key in response.
• List List all BambooHR custom reports new List available custom reports in BambooHR using company_domain. Returns report id and name fields.
• Get Get single BambooHR custom reports new by ID Get data for a specific custom report in BambooHR using company_domain and id. Returns the report data fields as specified in the report configuration.
• List List all BambooHR training Get a list of training types in BambooHR for the specified companyDomain. Returns trainingId for each training type.
• Create Create a BambooHR training Add a training type in BambooHR with required parameter name. Returns id, name, renewable, frequency, dueFromHireDate, required, category (id and name), linkUrl, description, and allowEmployeesToMarkComplete fields in the response.
• Update Update a BambooHR training by ID Update an existing training type in BambooHR using company_domain and id. Returns updated training type fields including id, name, renewable, frequency, dueFromHireDate, required, category (id and name), linkUrl, description, and allowEmployeesToMarkComplete.
• Delete Delete a BambooHR training by ID Delete an existing training type by id in BambooHR. Requires company_domain and id. Deletion succeeds only if all employee trainings for this type have been removed.
• List List all BambooHR training category Get a list of training categories in BambooHR. Requires company_domain. Returns categoryId objects containing the category ID and name.
• Create Create a BambooHR training category Add a training category with name in BambooHR. Requires companyDomain and name. Returns id and name of the created training category.
• Update Update a BambooHR training category by ID Update an existing training category by id in BambooHR. Requires company_domain and id. Returns updated category with id and name.
• Delete Delete a BambooHR training category by ID Delete an existing training category by id in BambooHR. Requires company_domain and id. Returns success status if deleted.
• List List all BambooHR employee training Get all training records for an employee in BambooHR using company_domain and id. Returns trainingId objects representing each training record.
• Create Create a BambooHR employee training Add a new employee training record for employeeId in BambooHR. Requires completed date in yyyy-mm-dd format and an existing training type id. Returns id, employeeId, completed, notes, instructor, credits, hours, cost, and type fields in the response.
• Update Update a BambooHR employee training by ID Update an existing employee training record in BambooHR with id. Requires completed date in yyyy-mm-dd format. Returns id, employeeId, completed, notes, instructor, credits, hours, cost, and type fields in the response.
• Delete Delete a BambooHR employee training by ID Delete an existing employee training record by id in BambooHR. Requires company_domain and id. Returns success status if the record is deleted.
• List List all BambooHR dataset data Query a BambooHR dataset (for example employee) and return its rows: choose the fields to return, filter with typed operators (contains, equal, lt, gte, last, next, range, includes …) combined by match=all or any, sort, optionally group by one field and aggregate (count, count_unique, sum, avg, min, max). Use dataset.list and dataset.fields to discover dataset and field names. This is the method the unified HRIS employees.list is built on. Returns data rows (each row's values keyed by field name), aggregations and pagination; when groupBy is used, data becomes an object keyed by group value. Required: datasetName, fields.
• Create Create a BambooHR alert configuration Create an alert configuration in BambooHR from one of its alert templates. Returns the stored configuration including its server-assigned id, bambooAlertId, filterListValueIds, and additionalRecipientEmails. Required: bambooAlertId. The configuration goes live immediately; repeating the call with the same bambooAlertId adds a second configuration rather than replacing one, and no endpoint deletes…
• Get Get single BambooHR alert configuration by ID Get one alert configuration the company has set up by id: which alert template it uses, when it runs, who receives it, and any list-value filters. Returns: id, schedule. Required: id. The id is the configuration's own identifier, not the bambooAlertId of its underlying template; no wildcard or 0 sentinel is supported.
• List List all BambooHR alert configurations List every alert configuration the company has set up: which alert template each one uses, when it runs, who receives it, and any list-value filters. Each entry includes: id, bambooAlertId, filterListValueIds, additionalRecipientEmails, employeeIds, listValueIds, and userIds. The response is a top-level JSON array with no wrapper, empty when none are configured, and in no guaranteed order.
• Update Update a BambooHR alert configuration by ID Replace an alert configuration by id, overwriting the whole configuration — a property left out of the body is reset to its default rather than kept. Returns: id, schedule. Required: id, bambooAlertId. The response echoes the submitted values rather than re-reading the saved row, and an update that omits the sendTo* properties can re-enable delivery to recipients the previous state excluded.
• List List all BambooHR alerts List BambooHR's built-in alert templates (e.g. New Hire, Birthdays, Time Off Approved) that company alert configurations are built from. Returns each template's id, name, and groupName, ordered by groupName then name. The catalog is global and not limited to features the company has enabled; use it to discover the id required as bambooAlertId when creating alert configurations.
• List List all BambooHR calendar events List BambooHR calendar events (time off, holidays, birthdays, and anniversaries) overlapping a date range, sorted by start date, then type, then id; TIME_OFF entries cover approved requests only and events the caller cannot view are omitted. Returns per event: id, type, start, employeeId, with remaining fields varying by event type. Required: start, end. The range must span less than one year;…
• List List all BambooHR compensation tools List the compensation tools and settings available for the company in BambooHR, covering Levels & Bands, Compensation Benchmarking, Compensation Planning, and Total Rewards. Returns the company's compensation tools object with tool-specific availability fields defined by BambooHR, plus upsell information when applicable.
• Update BambooHR employee verifications employees bulk update Update an employee verification record in BambooHR for a given employee. Partial update: any field omitted from the request body is left unchanged, and at least one updatable field must be supplied. Returns the updated verification record (employeeVerification) including verificationType, verificationStatus, verificationStatusNotes, and eVerifyStatus. Required: employee_id, verification_id.
• Get Get single BambooHR employee verifications employee by ID List employee verification records for a BambooHR employee by id, including archived rows, newest first. Returns: id, employeeId, integrationType, verificationType, verificationStatus, verificationStatusNotes, remoteAccessUrl, eVerifyStatus, archived, billingProcessed, createdByUserId, createdYmdt, lastModifiedYmdt, startDateYmdt. Required: id (the employee's internal ID).
• Update BambooHR employee verifications integrations bulk update Enable or disable the BambooHR employee verification integration. Returns the integration state object (integration) including its enabled flag and integrationType. Required: enabled. Enabling installs the configured partner app and schedules the daily sync (the company must have a valid US work location); disabling tears it down. Idempotent — repeat calls to the same state return the same object.
• List List all BambooHR employee verifications integrations Get the employee verification integration status in BambooHR. Returns the integration status object including its enabled flag (whether the partner app is installed and usable) and integrationType (the configured verification partner). Takes no parameters.
• Update BambooHR equity settings bulk update Update the company-level equity settings in bamboohr, covering calculation type, valuation, shares, pricing, and vesting configuration. Returns the updated settings object including calculationType, companyValuation, outstandingShares, pricePerShare, and vestingConditions. Requires an equity settings request body.
• List List all BambooHR equity settings Get the company-level equity settings configured in bamboohr, including calculation type, valuation, shares, pricing, and vesting configuration. Returns: calculationType, companyValuation, outstandingShares, pricePerShare, currencyCode, sliderMin, sliderMax, vestingConditions, disclaimers. Takes no parameters.
• Create Create a BambooHR holiday Create a BambooHR company holiday. The body may be fully specified or carry a globalHolidayUuid that seeds the holiday's details from the global catalog entry; partner-supplied values override catalog defaults. Returns: id, name, audience, createdAt, updatedAt, deletedAt.
• Delete Delete a BambooHR holiday by ID Delete a BambooHR company holiday by id. Soft-deletes the holiday and removes its audience, pay, and country sub-rows; deleting a missing or already-deleted holiday also succeeds. Returns an empty 204 response on success. Required: id.
• Get Get single BambooHR holiday by ID Get a BambooHR company holiday by id. Returns: id, name, audience, createdAt, updatedAt, deletedAt. Required: id.
• List List all BambooHR holidays List active BambooHR company holidays; soft-deleted holidays are never returned. Supports OData filtering via filter, sorting via orderBy, and field projection via select. Returns: id, name, startDate, endDate, isPublic, countryCodes, audience, holidayPay, globalHolidayUuid, createdAt, updatedAt, deletedAt. Max 100 per page.
• Update Update a BambooHR holiday by ID Update a BambooHR company holiday by id with a JSON Merge Patch document; only patched fields change, and countryCodes, audience, and holidayPay replace their stored blocks wholesale when supplied. Send null endDate to revert to a single-day holiday and null holidayPay to clear the pay treatment. Returns: id, name, audience, createdAt, updatedAt, deletedAt. Required: id.
• Create Create a BambooHR holidays bulk insert Bulk create company holidays in BambooHR from a JSON array of 1-100 holiday records, each fully specified or seeded from a global catalog entry via globalHolidayUuid. Returns an opaque bulk-insert result envelope. With atomic=true any per-record failure aborts the whole batch; otherwise records commit independently and partial failures are reported per record.
• Get Get single BambooHR holidays catalog by ID Get a single holiday catalog entry from BambooHR's global holiday catalog by its UUID. Returns: uuid, name, type, startDate, endDate, countryCode, source. Required: id (the catalog entry UUID).
• List List all BambooHR holidays catalogs List entries in the BambooHR global holiday catalog — read-only reference data whose uuid values are used to seed company holidays. Returns each catalog holiday's uuid, name, type, countryCode, and startDate. Supports optional countryCode and year filters; max 100 results per page.
• Create Create a BambooHR user send email Send a BambooHR employee verification lifecycle email (signup_survey or app_installed) for a specific user to the company owner contact. Returns: status, message. Required: user_id and emailType. The email is queued for delivery; the employee verification integration must be enabled; not an employee I-9 reminder.
• Delete BambooHR approvals employees bulk delete Remove an employee from all approval chains for a specific compensation planning cycle in bamboohr. Returns the updated approval flows after removal as an open object whose exact keys depend on the cycle's approval flow configuration. Required: planning_cycle_id, employee_id.
• Create Create a BambooHR approvals final approver Set or update the final approver for all approval flows in a BambooHR compensation planning cycle. Returns the updated approval flows for the cycle as a free-form JSON object. Required: planning_cycle_id, employee_id.
• Update BambooHR budgets breakdowns bulk update Save the budget breakdown for a compensation planning cycle in BambooHR by sending an array of per-employee entries (id, employeeId, and budgetAllocations with salaryIncrease, bonuses, and equity). Returns an empty 204 response on success. Required: planning_cycle_id.
• Update BambooHR budgets guidelines bulk update Save budget guidelines for a compensation planning cycle in bamboohr. Sets whether guidelines are enabled along with the soft minimum and maximum values, and returns the saved guidelines view. Returns: useGuidelines, softMinimum, softMaximum, guidelinesWarningErrors, requireComments, softMin, softMax. Required: planning_cycle_id.
• Create Create a BambooHR budgets import Import a budget breakdown into a BambooHR compensation planning cycle from structured per-employee data and apply it to allocations. Returns: message. Required: planning_cycle_id, budgetBreakdown (array of items with employeeName, emailAddress, and salary/bonus/equity budget values).
• Update BambooHR change comm templates bulk update Save the change communication email template for a BambooHR compensation planning cycle. Returns: message. Required: planning_cycle_id, subjectText, messageText. Only applies to cycles whose letter is a single message (section-based cycles are rejected with nothing written); a successful save also marks the cycle's change communications reviewed, which launching requires.
• Create Create a BambooHR compensation planning cycle Create a new compensation planning cycle in BambooHR with default settings. Returns the created cycle including its id and attributes. No request body is required.
• Delete Delete a BambooHR compensation planning cycle by ID Delete a compensation planning cycle in BambooHR by id. Returns an empty 204 response on success. Required: id.
• Get Get single BambooHR compensation planning cycle by ID Get a compensation planning cycle's details and currency settings in BambooHR. Returns the cycle including its id and attributes. Required: id.
• List List all BambooHR compensation planning cycles List all compensation planning cycles for the BambooHR company. Returns each cycle including its id, status, and attributes; the vendor does not publish a field-level response schema.
• Update Update a BambooHR compensation planning cycle by ID Update a compensation planning cycle's details and currency settings in BambooHR. Returns the updated cycle including its id and attributes. Required: id and a JSON body with the cycle details and currency settings to update.
• Update BambooHR compensation planning cycles update complete Complete a compensation planning cycle in bamboohr and finalize its employee compensation records. Returns: cycleId, updatedEmployeesCount, cycleClosedEmailError, errors. Required: planning_cycle_id. cycleClosedEmailError is set when closed-cycle emails fail to send.
• Delete BambooHR planning cycle admins bulk delete Remove a cycle admin from a BambooHR compensation planning cycle by internal employee ID. Full account admins cannot be removed. Returns an empty 204 response on success. Required: planning_cycle_id, employee_id.
• Create Create a BambooHR planning cycle admin Add one or more cycle admins to a BambooHR compensation planning cycle by internal employee IDs. Returns: added, skipped. Required: planning_cycle_id, employeeIds.
• List List all BambooHR planning cycle admins List the admins of a BambooHR compensation planning cycle. Returns the admins array — each admin with employeeId, displayName, firstName, lastName, jobTitle, photoUrl, adminType (FULL_ACCOUNT_ADMIN or CYCLE_ADMIN), isRemovable, addedAt, and addedByEmployeeId — plus isFullAdmin indicating whether the requesting user is a full compensation plan admin. Required: planning_cycle_id.
• Update BambooHR planning cycle approvals bulk update Update an approval flow for a compensation planning cycle in BambooHR, modifying the recommenders and approvers for a specific approval flow template. Returns the updated approval flows for the cycle as an open object whose keys follow the requested grouping (e.g. department). Required: planning_cycle_id, template_id, assignees, flowData.
• List List all BambooHR planning cycle approvals Get approval flows for a compensation planning cycle in BambooHR, grouped by department by default. Returns the approval-flows response as an open object whose keys follow the requested grouping. Required: planning_cycle_id.
• List List all BambooHR planning cycle budgets Get the budget guidelines and breakdown for a compensation planning cycle in BambooHR. Returns an open-ended budgets object (CompensationPlanningCycleBudgetsResponse) carrying the cycle's budget guidelines and breakdown data; BambooHR does not enumerate its fields. Required: planning_cycle_id.
• Get Get single BambooHR planning cycle change comm by ID Get the change communication letter details for a BambooHR compensation planning cycle by id. Returns: changeCommunicationMessageText, changeCommunicationSubjectText, cycleStatus, variablePlaceholders, hasSections, sections. hasSections and sections are absent when the cycle no longer exists, and sections is empty while the cycle still uses a single message. Required: id.
• Delete BambooHR planning cycle employees bulk delete Remove employees from a BambooHR compensation planning cycle by internal employee ID. Requires planning_cycle_id and employeeIds (array of internal employee IDs to remove). Returns an empty 204 response on success.
• Create Create a BambooHR planning cycle employee Add employees to a BambooHR compensation planning cycle by internal employee ID. Requires planning_cycle_id and employeeIds (array of internal employee IDs to add). Returns an empty 204 response on success.
• List List all BambooHR planning cycle employees List employees in a BambooHR compensation planning cycle (picker data: company roster and membership). Returns data, meta, and _links; each employee record includes employeeId, firstName, lastName, preferredName, photoUrl, jobTitleName, status, and _restrictedFields. Required: planning_cycle_id.
• Update BambooHR planning cycle launches bulk update Launch a BambooHR compensation planning cycle, validating all cycle data and setting the cycle's status to Live. Returns an empty 204 response on success. Required: planning_cycle_id. The cycle must be a draft and fully ready to launch; otherwise the call fails with a CYCLE_NOT_READY error naming the blocking requirement, and re-launching an already-live cycle is not retried.
• Create Create a BambooHR planning cycle recommendation Save compensation recommendations for an employee in a BambooHR planning cycle. Returns the saved-recommendation response object (BambooHR publishes it as a generic JSON object without enumerated fields). Required: planning_cycle_id, employeeId, assigneeEmployeeId, approvalStage.
• Get Get single BambooHR planning cycle summary by ID Get the summary of a BambooHR compensation planning cycle. Returns the summary object with the cycle's progress and stats data; the exact field set is not enumerated upstream. Required: id.
• Get Get single BambooHR planning cycle worksheet by ID Get the compensation planning worksheet for a bamboohr planning cycle by id. Returns a worksheet object with fields that vary by requested context (recommendations, approvals, or overview; overview requires cycle admin). Required: id.
• Create Create a BambooHR recommendations send Send compensation recommendations to the next approval stage for a planning cycle in bamboohr. Returns: message. Requires planning_cycle_id, templateId, assigneeEmployeeId, and approvalStage.
• Get Get single BambooHR worksheet export by ID Export a BambooHR compensation planning cycle worksheet to CSV. Returns the worksheet data as a UTF-8 CSV file download (Excel-friendly BOM); omit type for the default worksheet view. Required: id. The overview context requires cycle admin.
• Create Create a BambooHR employee onboarding experience Create (start) a BambooHR onboarding experience workflow for an employee's existing new hire packet. Returns the created onboarding experience record including its id, employeeId, and upstream-defined experience attributes. Requires employee_id. The company's onboarding experience toggles must be enabled, and the employee must not already have a running experience.
• Get Get single BambooHR employee onboarding experience by ID Get a single BambooHR onboarding experience by id for an employee. Returns the onboarding experience record including its id, employeeId, and upstream-defined experience attributes. Requires employee_id and id. The id must match the employee's current new hire packet instance while its workflow execution is running.
• List List all BambooHR employee onboarding experiences List BambooHR onboarding experiences for an employee. Returns onboarding experience summaries, each with its id, employeeId, and upstream-defined experience attributes. Requires employee_id. The list is empty when no workflow is currently running for the employee.
• Update BambooHR new hire packet question visibilities bulk update Update GTKY (get-to-know-you) answer visibility for a BambooHR new hire packet, applying the hidden flag to all answer rows or only the questions in questionIds. Returns the current visibility for each GTKY answer row: responseId, questionId, hidden. Required: new_hire_packet_id and hidden. Updates are rejected once the employee's hire date is reached.
• Cancel BambooHR new hire packets cancel Cancel a BambooHR new hire packet. Completed packets cannot be cancelled. Returns: id, location, cancelled, status. Required: new_hire_packet_id and id (the packet's numeric identifier).
• Create Create a BambooHR new hire packet Create a new BambooHR new hire packet draft for an employee, applying company configuration for default inclusion flags. Returns: id, employeeId, location, cancelled, status. Required: employeeId. Fails if the employee already has an in-progress packet.
• Delete Delete a BambooHR new hire packet by ID Delete a BambooHR new hire packet by id. Returns an empty 204 response on success.
• Get Get single BambooHR new hire packet by ID Get a single BambooHR new hire packet by id. Sub-resources (sections, tasks, questions, GTKY) are not included. Returns: id, location, cancelled, status. Required: id.
• List List all BambooHR new hire packets List BambooHR new hire packets for the company as flat summaries (no sections, tasks, questions, or GTKY recipients). Returns: id, employeeId, contactEmployeeId, requiresPersonalInformation, requiresPhoto, requiresPersonalQuestions, arriveByTime, location, sentDatetime, viewedDatetime, completedDatetime, createdByUserId, createdDatetime, sendGetToKnowYouEmail, getToKnowYouEmailSent,…
• Send BambooHR new hire packets send Send a BambooHR new hire packet to its employee by email or the onboarding experience workflow, depending on company configuration. Returns the packet object (id plus packet attributes). Required: new_hire_packet_id. The packet must be in draft state.
• Update Update a BambooHR new hire packet by ID Update an existing BambooHR new hire packet. Returns the updated packet object (id plus packet attributes); sent, viewed, and completed timestamps are not changed through this endpoint. Required: id and a JSON request body.
• List List all BambooHR onboarding new hire widgets List the upcoming new hires that power the BambooHR home "Welcome New Hires" widget, ordered by most recent hire date first. Returns: id, preferredFirstName, lastName, hireDate, profilePictureUrl, department, location, canSeeEmployee, getToKnowYou. The list is empty when the caller lacks new-hire-packet or company-directory access.
• List List all BambooHR policie versions List a BambooHR time off policy's rate-table versions (both currently effective and archived) with milestones inlined, ordered by effective date descending. Returns: id, policyId, effectiveDate, status, rateTransitions, firstAccrual, carryOverYmd, negativeBalanceResetOnCarryOver, milestones, createdAt, updatedAt. Required: policy_id. Unlimited and manual policies return an empty list; max 100 per…
• Get Get single BambooHR schedule PDF by ID Download a PDF of a specific schedule in BambooHR for a given date range, with options to group employees by location, department, division, job title, or team. Returns the rendered schedule as a PDF binary stream (application/pdf), not JSON. Required: id, startYmd, endYmd.
• Create Create a BambooHR scheduling schedule Create a new schedule in BambooHR. Returns the created schedule object including its id, name, locationId, timezone, startOfWeek, clock-in/out thresholds, and createdAt/updatedAt timestamps. Duplicate schedule data for the same location and configuration is rejected.
• Delete Delete a BambooHR scheduling schedule by ID Delete a BambooHR schedule by id. Unworked shifts belonging to the schedule are deleted as a result. Returns an empty 204 response on success. Required: id.
• Get Get single BambooHR scheduling schedule by ID Get a single BambooHR schedule by its UUID id. Returns the schedule object including its id, name, locationId, timezone, startOfWeek, clock-in/out thresholds, and createdAt/updatedAt timestamps. Required: id.
• List List all BambooHR scheduling schedules List BambooHR schedules for the company. Returns schedule records including id, name, locationId, timezone, clock-in/out thresholds, and createdAt/updatedAt. Supports optional OData-style filter and sort. Defaults to 100 per page.
• Update Update a BambooHR scheduling schedule by ID Partially update a BambooHR schedule by id; fields not provided retain their existing values. Returns the updated schedule object including its id, name, locationId, timezone, clock-in/out thresholds, and createdAt/updatedAt timestamps. Required: id.
• List List all BambooHR scheduling shift assessments List BambooHR shift assessments matching an OData v4 filter. Returns: id, shiftId, employeeId, date, result, violations, createdAt, updatedAt. Required: filter (must include at least one of employeeId, shiftId, or a date comparison). Max 1000 per page.
• Create Create a BambooHR scheduling shift Create a new shift in a BambooHR schedule. Returns the created shift object including id, status, employeeIds, and recurrence. Requires a JSON request body; BambooHR documents the field-level schema in its Create Shift API reference.
• Delete Delete a BambooHR scheduling shift by ID Delete a BambooHR shift by id (its UUID or projected composite recurrence ID). Returns an empty 204 response on success. Required: id. Use recurrenceEditOption to delete a single instance or the whole recurrence series.
• Get Get single BambooHR scheduling shift by ID Get a single BambooHR shift by id (UUID). Returns the full shift object including id, status, employeeIds, and recurrence settings; returns 404 if the shift does not exist or has been deleted. Required: id.
• List List all BambooHR scheduling shifts List BambooHR shifts matching filters. Returns shift objects with id, status, employeeIds, and recurrence. Provide either ids, or start and end plus at least one of employeeIds or scheduleIds; the time window must be no longer than 1 month.
• Update Update a BambooHR scheduling shift by ID Update a BambooHR shift by id; fields not provided retain their existing values. Returns the updated shift object including id, status, employeeIds, and recurrence. Required: id. recurrenceEditOption is required when the shift already has recurrence settings, and a stale updatedAt is rejected with 409.
• List List all BambooHR scheduling timezones List BambooHR timezones available for use when creating or editing schedules, with OData-style filtering on the name field and sorting by name or UTC offset. Returns each timezone's name and offset. No required parameters.
• Create Create a BambooHR shifts publish Publish one or more planned shifts in BambooHR, making them visible to employees; shifts with scheduling conflicts are skipped and reported as failures. Returns a publish result object (Scheduling-PublishShiftsResult-V1) with upstream-defined fields reporting which shifts were published and which failed. Returns 200 if all shifts succeed, 207 if some fail, 409 if all fail. Required: shiftIds (1…
• Create Create a BambooHR time off category Create a time off category in BambooHR. Returns the created category including id, name, enabled, and unit. Required: name. Category names are unique across all of the company's categories, including disabled and deleted ones; a colliding name is rejected with the conflicting category identified.
• Delete Delete a BambooHR time off category by ID Delete a time off category by id in BambooHR. Soft deletes the category, unassigns and soft deletes every active policy under it, and removes it from payroll; historical balances and requests are preserved. Returns an empty 204 response on success. Required: id. Idempotent: a non-existent or already-deleted id also succeeds.
• Get Get single BambooHR time off category by ID Get a single time off category by id in BambooHR. Returns: id, name, unit, color, icon, paid, includeInPayroll, enabled, createdAt, updatedAt, deletedAt, deleted, hoursPerDay. Disabled categories are returned with enabled set to false; soft-deleted categories are treated as non-existent. Required: id.
• Update Update a BambooHR time off category by ID Update a time off category by id in BambooHR using merge-patch semantics — only fields present in the body change. Returns the updated category including id, name, enabled, unit, and hoursPerDay. Required: id. Changing unit converts all existing balances and requests and requires hoursPerDay; setting enabled to false disables the category and removes it from payroll.
• Delete BambooHR time off policies bulk delete Unassign a time off policy from a BambooHR employee. End-dates the assignment as of today while preserving historical balances and time off requests, and also ends any later-starting assignment in the same category; idempotent. Returns an empty 204 response on success. Required: employee_id, assignment_id.
• Update BambooHR time off policies bulk update Assign time off policies to a BambooHR employee in bulk (deprecated v1 endpoint). Supply one entry per policy; a null accrualStartDate removes an existing assignment. Returns the current list of assigned policies, each with timeOffPolicyId, timeOffTypeId, and accrualStartDate. Required: employee_id and a body array of timeOffPolicyId and accrualStartDate entries.
• Update BambooHR time off policies bulk update time off Update a BambooHR employee's time off policy assignment using merge-patch semantics: the addressed assignment is kept as a SUPERSEDED audit copy and replaced by a new one. Returns the assignment under a new id, with policyId, effectiveDate, endDate, status, and supersededAssignments. Required: employee_id, assignment_id. At least one of policyId or effectiveDate must be sent in the body; neither…
• Create Create a BambooHR time off policy Create a BambooHR time off policy. Returns the created policy including id, name, type, currentVersion (inlined with milestones for accruing policies only), createdAt, and updatedAt. Required: name.
• Delete Delete a BambooHR time off policy by ID Delete a BambooHR time off policy by id. Soft-deletes the policy, automatically unassigns every assigned employee, and retains historical balances and time off requests; idempotent. Returns an empty 204 response on success. Required: id.
• Get Get single BambooHR time off policy by ID Get a single time off policy in BambooHR by id. Returns the policy object including id, name, type, categoryId, createdAt, and updatedAt; accruing policies also include currentVersion, the currently effective accrual schedule with milestones inlined. Required: id.
• List List all BambooHR time off policies List the time off policies assigned to an employee in BambooHR, ordered by effective date descending with the most recent assignment first; only active assignments are returned. Returns assignment records including id, policyId, categoryId, effectiveDate, endDate, and status. Required: employee_id.
• Update Update a BambooHR time off policy by ID Partially update a time off policy in BambooHR by id using JSON Merge Patch semantics; supplying a new accrual schedule version replaces the complete schedule by archiving overlapping versions and creating a new one. Returns the updated policy including id, name, type, categoryId, and currentVersion. Required: id. The policy's type and categoryId cannot be changed.
• Update BambooHR time off policies bulk update assign Assign time off policies to an employee in BambooHR with accruals starting on the given date; setting accrualStartDate to null removes an existing assignment. Returns the current list of assigned policies including manual and unlimited types, each with timeOffPolicyId, timeOffTypeId, and accrualStartDate. Required: employee_id and a body array of { timeOffPolicyId, accrualStartDate }.
• Create Create a BambooHR time off policies time off Assign a time off policy to a BambooHR employee, effective from effectiveDate. Returns the created assignment (id, policyId, effectiveDate, endDate, status) plus supersededAssignments listing same-category assignments the call end-dated or archived. Required: employee_id, policyId, effectiveDate. endDate is not accepted; re-assigning the same policy with the same effective date is refused.
• List List all BambooHR time off policies time off List the time off policies assigned to a BambooHR employee, ordered by effective date descending (most recent first). Returns active assignments with id, policyId, categoryId, effectiveDate, endDate, and status. Required: employee_id.
• List List all BambooHR time off policies time off List all non-deleted time off policies in bamboohr, sorted alphabetically by name. Returns: id, timeOffTypeId, name, effectiveDate, type. Only includes policies whose time off type has not been deleted.
• List List all BambooHR time off requests List BambooHR time off requests with OData filtering and sorting support. Returns each request's id, employeeId, categoryId, startDate, endDate, amount, unit, status, and requestedAt. Max 1000 per page.
• Action BambooHR time off requests attach comment Add a comment to a BambooHR time off request. Returns the created comment including its id and createdAt. Required: request_id. Empty or whitespace-only comments are rejected.
• Update BambooHR time off requests bulk update Create a time off request for a BambooHR employee via the employee-scoped endpoint. Returns the created request including its id, employeeId, name, start, end, created, status, type, amount, and notes. Required: employee_id. Submitting status approved or denied requires owner/admin or time-off-type field access; a previousRequest id destructively supersedes the prior request.
• Create Create a BambooHR time off request Create a time off request in BambooHR on behalf of an employee; it is created with status REQUESTED and enters the approval workflow. Returns the created request including its id, employeeId, categoryId, startDate, endDate, amount, unit, and requestedAt.
• Get Get single BambooHR time off request by ID Get a single BambooHR time off request by id. Returns: id, amount, unit, status, _links. Required: id.
• Update Update a BambooHR time off request by ID Update a BambooHR time off request by id using JSON Merge Patch semantics — only fields present in the body change, and employeeNote may be set to null to clear it. Returns: id, amount, unit, status, _links. Editing a REQUESTED request replaces it, so the returned id is authoritative and the replaced id returns 410 thereafter; changing startDate or endDate requires dailyAmounts. Required: id.
• Create Create a BambooHR time tracking project Create a time tracking project in bamboohr using the legacy contract. Returns the created (or restored) project with its tasks, including id, name, tasks, and employeeIds. Requires name. If a deleted project with the same name exists it is restored with the supplied values instead of a new project being created; this legacy endpoint is deprecated in favor of the current create endpoint.
• Delete Delete a BambooHR time tracking project by ID Delete a time tracking project in bamboohr by id. Returns an empty 204 response on success. Required: id.
• Get Get single BambooHR time tracking project by ID Get a single time tracking project in bamboohr by id, including the employees assigned to it. Returns: id, name, billable, includeInPayroll, allEmployeesAssigned, archived, hasTasks, createdAt, updatedAt, deletedAt, employeeIds, employees. Required: id.
• List List all BambooHR time tracking projects List time tracking projects in bamboohr with OData-style filtering and sorting. Returns projects with id, name, billable, includeInPayroll, allEmployeesAssigned, archived, and employees. Max 500 per page; required: none.
• Update Update a BambooHR time tracking project by ID Partially update a time tracking project in bamboohr by id; only fields provided in the request body are changed. Returns the updated project: id, name, billable, includeInPayroll, employees. Required: id. At least one body field must be supplied.
• Create Create a BambooHR time tracking projects time tracking Create a time tracking project in BambooHR. Returns the created project including id, name, hasTasks, billable, and createdAt; if a deleted project with the same name exists, it is restored with its existing id instead. Required: name. Created tasks are not embedded; retrieve them via the project task list.
• Create Create a BambooHR request approval Approve a BambooHR time off request, completing the caller's step in the approval chain (or every remaining step when bypass is true). Returns the updated request with its id, status (still REQUESTED while further approvals are outstanding), and _links when returnActions is set. Required: request_id.
• Create Create a BambooHR request cancellation Cancel a time off request in bamboohr. Allowed while the request is in REQUESTED status, and after approval only if it has not started yet. Returns the updated time off request including its id and, when returnActions is true, the _links block of available state transitions. Required: request_id. Takes no request body.
• Create Create a BambooHR request denial Deny a BambooHR time off request. The denial is final: it completes the caller's step in the approval chain and discards any remaining steps, so the returned request is always in DENIED status. Returns: id, amount, unit, status, _links. Required: request_id.
• List List all BambooHR time off requests comments List the comments on a BambooHR time off request, ordered oldest first; an empty thread returns an empty array. Returns each comment's id and its schema-defined comment fields (attributes). Required: request_id.
• List List all BambooHR time off requests time off List BambooHR time off requests overlapping a start/end date window or changed on/after updatedSince. Returns each request's id, employeeId, name, start, end, status, type, amount, actions, dates, and notes. Requires start and end together, or updatedSince. Use action=myRequests for the caller's own requests; employeeId=0 is not supported here.
• Assign BambooHR time tracking break policies assign Assign employees to a BambooHR break policy, adding them without removing existing assignments. Returns an empty 204 response on success. Required: break_policy_id, employeeIds (at least one internal employee ID).
• Create Create a BambooHR time tracking break policy Create a BambooHR break policy; breaks and employee assignments can optionally be created in the same request. Returns the created policy with id, description, createdAt, updatedAt, and deletedAt. Requires a JSON request body.
• Delete Delete a BambooHR time tracking break policy by ID Delete a BambooHR break policy by id. Associated breaks and employee assignments are also removed. Returns an empty 204 response on success. Required: id.
• Get Get single BambooHR time tracking break policy by ID Get a single BambooHR break policy by id. Returns: id, name, description, allEmployeesAssigned, createdAt, updatedAt, deletedAt. Set includeCounts to also include employee and break counts. Required: id.
• List List all BambooHR time tracking break policies List BambooHR time tracking break policies with OData v4 filtering. Returns: id, name, description, allEmployeesAssigned, createdAt, updatedAt, deletedAt. Set includeCounts to include employee and break counts per policy. Max 500 per page.
• Action BambooHR time tracking break policies unassign Unassign employees from a break policy in BambooHR without affecting the policy itself or other assigned employees. Returns an empty 204 response on success. Required: break_policy_id and employeeIds (array of internal employee IDs). Only policies that are not assigned to all employees can be unassigned.
• Update Update a BambooHR time tracking break policy by ID Partially update a break policy in BambooHR by id; only fields provided in the request body are changed. Returns the updated break policy including its id, name, description, and createdAt/updatedAt timestamps. Required: id (UUID).
• Update BambooHR time tracking break policies update assign Set the employee assignments for a break policy in BambooHR; the provided list replaces all existing assignments. Returns an empty 204 response on success. Required: break_policy_id and employeeIds (array of internal employee IDs).
• Update BambooHR break policie breaks bulk update Replace all breaks for a BambooHR break policy: items with an id are updated, items without an id are created, and existing breaks omitted from the payload are soft-deleted. Returns the resulting breaks including id, name, duration, paid, availabilityType, and the availability window. Required: break_policy_id; each payload item requires name, duration, paid, and availabilityType.
• Create Create a BambooHR break policie break Create a new break in BambooHR and associate it with a break policy. Returns the created break including id, name, duration, paid status, availabilityType, and the availability window. Required: break_policy_id, name, duration, paid, availabilityType.
• List List all BambooHR break policie breaks List the breaks configured on a BambooHR break policy, with OData v4 filtering support (e.g. `paid eq true and name ne 'Quick Break'`). Returns each break's id, name, duration, paid status, availabilityType, availability window, and createdAt/updatedAt. Required: break_policy_id. Max 500 per page.
• Update BambooHR break policie syncs bulk update Sync a BambooHR Time Tracking break policy by fully replacing its state; any breaks or employee assignments omitted from the payload are removed (unlike the partial update endpoint). Returns: id, name, description, allEmployeesAssigned, createdAt, updatedAt, deletedAt, breaks, employeeIds. Required: break_policy_id and a request body describing the full policy state.
• Get Get single BambooHR break policies suggestion by ID Get AI-generated meal and rest break policy suggestions in BambooHR. An AI agent analyzes existing break policies and company context and returns structured recommendations ready for form pre-fill. Returns suggestedPolicies, each with id, title, description, and breaks. Required: prompt (non-empty).
• List List all BambooHR employee break availabilities List an employee's break availabilities in BambooHR Time Tracking. Returns the collection of break availability records computed as of the effective time; the published spec does not enumerate the record fields. Required: employee_id. The effective parameter defaults to the current time and must be in Y-m-d\TH:i:s format with no timezone offset.

No tools match your search.