Bamboohr

Creates a new employee record in the bamboohr system. this endpoint allows you to add a new employee to your company's hr database by providing essential information such as first name and last name. it's typically used when onboarding new hires or adding existing employees to the bamboohr system for the first time. the endpoint supports additional properties beyond the required fields, allowing for flexible and comprehensive employee data entry. however, it's important to note that this endpoint only initiates the employee record and may not include all possible employee information fields available in bamboohr.

Retrieves detailed information for a specific employee within a company's bamboohr system. this endpoint allows you to fetch comprehensive employee data using the employee's unique identifier. it's particularly useful when you need to access or display individual employee records, update employee information, or verify employee details. the endpoint returns all available fields for the employee, which may include personal information, job details, compensation data, and custom fields configured for the company. use this endpoint when you need specific, up-to-date information about a single employee. note that the exact fields returned may vary based on the company's bamboohr configuration and the permissions of the authenticated user making the request.

Retrieves the employee directory for a specified bamboohr company. this endpoint provides a list of employees within the company, including basic information such as names, job titles, and departments. it's useful for getting an overview of the company's workforce or for integrating employee data into other systems. the endpoint should be used when you need a comprehensive list of employees, but it may not include detailed information about each employee. for more specific or detailed employee data, consider using custom reports or individual employee endpoints instead. keep in mind that the amount and type of information returned may depend on the user's permissions within the bamboohr system.

Updates an employee's basic information in the bamboohr system. this endpoint allows you to modify an employee's first name and/or last name. it should be used when there's a need to correct or change an employee's name in the hr records, such as in cases of marriage, divorce, or legal name changes. the endpoint accepts partial updates, meaning you can update either the first name, last name, or both. any additional properties sent in the request will also be accepted due to the 'additionalproperties: true' setting, but their behavior is not specified in this schema. it's important to note that this endpoint only updates name information and should not be used for modifying other employee data such as contact details or job information.

This endpoint allows you to update a specific row in an employee's table within bamboohr. it is used to modify various aspects of an employee's record, such as their job information, location, or organizational structure. the endpoint is particularly useful for keeping employee data up-to-date when changes occur, such as promotions, transfers, or organizational restructuring. it's important to note that this endpoint updates a single row in a specific table, so multiple calls may be necessary for comprehensive employee record updates across different tables.

Creates or updates an employee benefit in the bamboohr system. this endpoint allows you to manage various aspects of an employee's benefit enrollment, including coverage details, financial contributions, and enrollment status. it's primarily used when setting up new benefits for an employee, making changes to existing benefits, or updating enrollment statuses. the endpoint is versatile, handling different types of benefits with various contribution structures for both employees and the company. it's important to note that while many fields are optional, they may be required depending on the specific benefit type and company policies. this endpoint should not be used for bulk updates or to retrieve benefit information; separate endpoints likely exist for those purposes.

This endpoint allows you to create a new dependent for an existing employee in the bamboohr system. it is used to add family members or other individuals who are dependent on the employee, which is crucial for benefits administration, tax purposes, and other hr-related tasks. the endpoint requires detailed information about the dependent, including personal details, contact information, and status indicators. it should be used when onboarding new employees with dependents, updating family information, or managing benefits enrollment periods. note that some fields contain sensitive personal information, so ensure proper data security measures are in place when using this endpoint.

This endpoint updates an employee's withholding information for tax purposes in the bamboohr system. it allows modification of federal, state, and local tax withholding amounts, including any additional withholdings, as well as specifying the applicable tax state and local jurisdiction. this tool should be used when there are changes to an employee's tax situation, such as filing status changes, additional jobs, or relocation. it's crucial for maintaining accurate payroll calculations and tax compliance. the endpoint doesn't calculate tax amounts; it only updates the stored values based on the provided information. users should ensure they have the correct withholding information before making updates, as incorrect data may lead to under or over-withholding of taxes.

Updates the direct deposit account information for a specific employee in the bamboohr system. this endpoint allows you to modify existing direct deposit accounts or add new ones for an employee. it's particularly useful when an employee changes their bank account, adjusts their deposit allocations, or wants to split their paycheck across multiple accounts. the endpoint requires the company domain and employee id in the url path, and accepts an array of account objects in the request body, each detailing the specifics of a direct deposit account. this tool should be used with caution as it directly affects an employee's payment method, and any errors could result in payroll issues.

Creates a new employee pay stub in the bamboohr system. this endpoint allows for the detailed recording of an employee's pay information for a specific pay period, including gross and net pay, taxes, deductions, and direct deposit allocations. it should be used when processing payroll to maintain accurate financial records for each employee. the endpoint captures both current pay period data and year-to-date totals, providing a comprehensive view of an employee's earnings and deductions. it's particularly useful for integrating external payroll systems with bamboohr, ensuring that hr records are synchronized with actual payroll data. note that this endpoint does not process actual payments; it only records the pay stub information in the bamboohr system.

Posts unpaid pay stubs for a specific employee in the bamboohr system. this endpoint allows you to add or update information about pay periods for which an employee has not been paid. it's useful for tracking delayed payments, managing payroll discrepancies, or recording periods of unpaid leave. the function requires the employee's id and an array of unpaid period dates. use this when you need to update an employee's payroll record with periods that haven't been compensated yet. note that this endpoint doesn't process payments; it only records the unpaid periods for tracking and future processing.

This endpoint allows you to add a new time tracking record for an employee in the bamboohr system. it's used to log hours worked, including regular and overtime hours, along with associated details such as pay rates, job codes, and organizational information. the endpoint is essential for accurate time tracking, payroll processing, and reporting within bamboohr. use this when you need to manually input or programmatically add time entries for employees, ensuring that all required fields are provided and optional fields are included as needed for your specific payroll and reporting requirements.

This endpoint allows you to post a comment on a specific application in bamboohr's applicant tracking system. it's used to add notes, feedback, or any relevant information to an applicant's file during the recruitment process. the endpoint requires the company domain and application id to identify where the comment should be added, along with the comment text itself. it's particularly useful for collaboration among hiring team members, documenting interview feedback, or noting important details about an applicant. this function should be used whenever there's a need to update an application with new information in a comment format. note that this endpoint only handles adding comments and does not provide functionality for reading or modifying existing comments.

This endpoint allows you to associate an employee with a specific benefit group in bamboohr for a defined period. it's used when you need to enroll an employee in a new benefits package or update their existing benefits enrollment. the association can be set for a specific time frame or left open-ended for ongoing enrollment. this tool is particularly useful for hr administrators managing employee benefits, especially during onboarding, annual enrollment periods, or when an employee's benefit status changes. note that this endpoint only creates the association; it doesn't provide details about the benefits themselves or handle the actual enrollment process in specific benefit plans.

This endpoint creates a new company benefit in bamboohr. it allows hr administrators to set up various types of employee benefits, including health insurance, retirement plans, and reimbursement programs. the endpoint captures essential details such as benefit type, start and end dates, deduction information, and compliance with aca requirements. use this endpoint when adding a new benefit offering or updating an existing benefit with new terms. it's particularly useful during open enrollment periods or when changing benefit providers. note that this endpoint does not enroll employees in the benefit; it only sets up the benefit at the company level.

Adds a new time off history item to an employee's record in bamboohr. this endpoint is used to retroactively add time off requests to an employee's history, which is useful for maintaining accurate records of past time off, especially when backfilling data or correcting historical entries. it allows hr administrators to ensure that an employee's time off history is complete and up-to-date, which is crucial for accurate leave balance calculations and reporting. the endpoint requires the company domain and employee id to be specified in the url path, ensuring that the time off history item is added to the correct employee's record.

This endpoint allows you to add or update a time off request for a specific employee in bamboohr. it's used to submit new time off requests or modify existing ones, providing detailed information about the request such as start and end dates, type of time off, and any associated notes. this tool is essential for managing employee leave and maintaining accurate records of time off within the bamboohr system. it should be used whenever an employee needs to request time off or when hr needs to update an existing time off request. the endpoint doesn't handle approval workflows directly; it's primarily for creating and updating request data.

The "store time tracking clock entries" endpoint allows you to create or update multiple time tracking entries for employees in bamboohr. this endpoint is used to record working hours, including start and end times, dates, and optional project, task, and note information. it's particularly useful for batch processing of time entries, such as at the end of a pay period or when synchronizing data from another system. use this endpoint when you need to add new time entries or modify existing ones in bulk. it supports creating new entries and updating existing ones by specifying the entry id. the endpoint is designed for efficiency, allowing multiple entries to be processed in a single api call. note that this endpoint does not handle time entry approval workflows or payroll calculations directly. it's primarily for data entry and updates. ensure that the employee ids, project ids, and task ids used in the request correspond to valid entities in your bamboohr system to avoid errors.

This endpoint allows you to store or update multiple time tracking hour entries for employees in bamboohr. it's designed for bulk creation or modification of timesheet entries, enabling efficient management of employee work hours, project time allocation, and task tracking. use this endpoint when you need to submit time entries for one or more employees, associate work hours with specific projects or tasks, or update existing time entries. the endpoint is particularly useful for integrating external time tracking systems with bamboohr or for automating the process of time entry submission. note that while you can create multiple entries in a single request, each entry must contain the required fields (employeeid, date, and hours) to be valid. optional fields allow for more detailed time tracking and management capabilities.

This endpoint creates a new job application in the bamboohr applicant tracking system. it allows for the submission of a candidate's personal information, professional details, and supporting documents for a specific job opening. the endpoint accepts multipart/form-data, enabling the upload of resume and cover letter files along with text-based information. it should be used when a new candidate applies for a job or when bulk-uploading applications from external sources. the endpoint requires at minimum the candidate's first name, last name, and the job id, but allows for a comprehensive application with optional fields covering everything from contact details to educational background.

This endpoint allows you to create a new training record for a specific employee in the bamboohr system. it's used to document completed training sessions, including details such as the completion date, cost, instructor, duration, credits earned, and any additional notes. this tool is essential for maintaining accurate employee development records, tracking professional growth, and ensuring compliance with training requirements. it should be used whenever an employee completes a training session, workshop, or course that needs to be officially recorded in their hr file. the endpoint requires the company domain and employee id as part of the url, ensuring that the training record is associated with the correct employee in the appropriate company account.

Creates a new job opening in the bamboohr applicant tracking system. this endpoint allows you to set up a comprehensive job listing with detailed information about the position, requirements, and application process. use this when you need to post a new job opportunity, whether it's ready to be published or still in draft form. the endpoint captures essential job details and allows customization of the application form through various question fields. it's particularly useful for hr managers and recruiters who need to efficiently manage the hiring process. note that while you can create a job opening, this endpoint does not automatically publish or advertise the position; additional steps may be required to make the job visible to potential applicants.

Adds new values or updates existing values for a specific list field in the bamboohr system. this endpoint allows you to modify the available options for custom dropdown fields, multi-select fields, or other list-type fields in your bamboohr instance. it's particularly useful when you need to maintain consistent list options across your hr system, such as updating department names, job titles, or any other predefined lists used in employee records or forms. the endpoint requires the company domain and the specific list field id to be included in the url path, ensuring changes are applied to the correct field in the right company instance.

Clocks in an employee in the bamboohr time tracking system, marking the start of their work period. this endpoint should be used when an employee begins their work shift or returns from a break. it allows for optional association with specific projects and tasks, as well as the addition of a note for context. the function is particularly useful for remote workers or companies with flexible working hours. it does not provide clock-out functionality or retrieve existing time entries - separate endpoints would be required for those actions.

This endpoint clocks out an employee in the bamboohr time tracking system, marking the end of their working hours. it should be used when an employee finishes their work shift or needs to record the end of their working time. the endpoint is part of the time tracking api, which integrates with bamboohr timesheets for comprehensive time management. it's important to note that this endpoint only records the clock-out time and doesn't provide additional information about the employee's shift or total hours worked. ensure that the employee is currently clocked in before using this endpoint, as attempting to clock out an employee who isn't clocked in may result in an error.

Creates a new training category in the bamboohr system. this endpoint allows hr administrators to organize and structure their training programs by adding custom categories. use this when you need to introduce a new classification for training content, courses, or programs. the newly created category can then be used to group related training materials, making it easier for employees and managers to navigate and access specific types of training. this endpoint is essential for maintaining an organized and efficient training management system within bamboohr.

Creates a new training type in the bamboohr system with specified attributes and settings. this endpoint allows hr administrators to define and customize various aspects of a training program, including its name, description, renewal requirements, categorization, and completion settings. it's particularly useful for setting up new employee training programs, compliance courses, or skill development modules within an organization. the endpoint provides flexibility in configuring how the training is presented, tracked, and managed within the bamboohr platform.

The addwebhook endpoint allows you to create a new webhook in bamboohr, enabling real-time notifications for specific employee data changes. this tool is used to set up automated data synchronization between bamboohr and external systems, triggered by changes to monitored fields. it provides granular control over which data is sent, how often, and in what format. use this when you need to integrate bamboohr with other systems or automate workflows based on hr data changes. note that webhooks are subject to rate limiting and security constraints, so careful configuration is essential to ensure reliable and secure data transmission.

This endpoint allows you to adjust the time off balance for a specific employee in bamboohr. it's used to make corrections, add or subtract time off, or reconcile discrepancies in an employee's time off records. the adjustment is applied to a particular time off type (e.g., vacation, sick leave) on a specified date. this tool is particularly useful for hr administrators who need to manually modify time off balances due to policy changes, corrections, or special circumstances. it provides a way to maintain accurate time off records without altering the underlying accrual rules or past time off requests. note that this adjustment will be reflected in the employee's time off history and may affect future balance calculations.

Retrieves the available goal alignment options for a specific employee or the authenticated api user in bamboohr. this endpoint is used to fetch possible alignment choices for employee goals, which helps in ensuring that individual objectives are in line with broader organizational goals. the response includes the currently aligned option for the employee's goal, if one exists. this tool is particularly useful when setting up or adjusting employee performance goals, allowing for proper alignment with company objectives. it should be used when there's a need to view or update the alignment of an employee's goals within the performance management system. the endpoint does not modify any data; it only provides information about available alignment options.

This endpoint will approve all timesheets for employees that are currently clocked in. it will only approve the current timesheet, not any previous timesheets.

The approvetimesheets endpoint enables managers or authorized personnel to approve multiple employee timesheets in a single api call within the bamboohr time tracking system. this function streamlines the timesheet approval process, which is a critical step in payroll processing and ensuring accurate compensation for employees. it should be used at the end of a pay period or when managers need to approve a batch of completed timesheets. the endpoint requires the last modification timestamp and an array of timesheet ids to be approved, allowing for efficient batch processing. however, it does not provide the ability to partially approve or reject individual time entries within a timesheet; the approval applies to the entire timesheet for each id provided.

Retrieves the list of employees with whom a specific employee's goals can be shared within bamboohr. this endpoint is used to determine the visibility options for an employee's performance goals, allowing hr managers or system administrators to view and potentially modify goal sharing settings. it's particularly useful when setting up or reviewing goal visibility across the organization, ensuring appropriate access to performance information. the endpoint does not modify any data; it only provides information about current share options. it should be used when there's a need to understand or audit the goal visibility for a particular employee.

This endpoint checks whether a specific employee has the permission to create goals within the bamboohr performance management system. it is useful for determining user capabilities before attempting to create or modify goals, ensuring proper access control within the application. the endpoint should be used when setting up or managing goal-setting processes, or when building interfaces that dynamically adjust based on user permissions. it does not provide information about existing goals or other performance metrics, focusing solely on the create permission for goals.

Updates the status of a specific application in the bamboohr applicant tracking system. this endpoint allows you to change the current status of an application, which is useful for tracking the progress of candidates through your hiring process. use this when you need to move an application to a new stage, such as from 'new' to 'under review' or 'interviewed' to 'offer extended'. the status is represented by an integer id, which corresponds to predefined status options in your bamboohr setup. it's important to note that this endpoint only updates the status and doesn't provide additional information about the application or candidate. ensure you have the correct status id before making the call, as incorrect ids may lead to unexpected status changes.

This endpoint updates the status of a specific time-off request in bamboohr. it allows hr managers or authorized personnel to approve, deny, or cancel an employee's time-off request. the endpoint is used when a decision has been made regarding a pending time-off request or when there's a need to change the status of an existing request. it's particularly useful for maintaining accurate records of employee leave and ensuring proper workflow in the time-off management process. the endpoint also provides the option to attach a note to the status change, allowing for clear communication and documentation of the decision-making process.

Deletes a specific employee withholding record from the bamboohr system. this endpoint is used to remove tax deduction or other financial withholding information for an employee. it should be used when you need to permanently remove outdated, incorrect, or no longer applicable withholding data. this operation cannot be undone, so it should be used with caution. the endpoint requires the company's bamboohr subdomain and the unique identifier of the withholding record to be deleted. it does not return any content upon successful deletion, typically responding with a 204 no content status.

Deletes a specific direct deposit account associated with an employee in the bamboohr system. this endpoint should be used when an employee's direct deposit account needs to be removed, such as when an employee closes a bank account or requests removal of a direct deposit option. the deletion is permanent and cannot be undone, so it should be used with caution. this endpoint only removes the specified direct deposit account and does not affect other accounts or employee information.

This endpoint deletes a specific unpaid pay stub for an employee in the bamboohr system. it is used to remove outdated, erroneous, or unnecessary unpaid pay stub records from the company's hr database. the operation is irreversible, so it should be used with caution. this endpoint is particularly useful for correcting payroll mistakes, managing test data, or cleaning up records during employee offboarding processes. it does not affect paid pay stubs or other employee financial records beyond the specified unpaid pay stub.

This endpoint records a clock-in event for a specific employee in the bamboohr time tracking system. it allows for precise tracking of work hours, including the start time, associated project and task, and optionally, the location of the clock-in. this tool should be used when an employee begins their work day or returns from a break. it's particularly useful for organizations that need detailed time tracking, especially those with remote or field workers. the endpoint doesn't handle clock-out events or provide any information about ongoing or completed work periods.

This endpoint records the clock-out time for a specific employee in the bamboohr time tracking system. it should be used when an employee ends their work shift or workday. the endpoint requires the company domain, employee id, and the exact clock-out time. it supports specifying a timezone, which is particularly useful for companies with employees working across different geographical locations. this function is crucial for accurate time tracking, payroll processing, and compliance with labor regulations. note that this endpoint only records the clock-out event; it does not provide information about the total hours worked or any other time tracking data.

The clockoutemployee endpoint allows you to record an employee's clock-out time and location in the bamboohr time tracking system. this endpoint should be used when an employee finishes their work session and needs to log their end time and current location. it captures precise geolocation data along with a readable address to ensure accurate time and location tracking for payroll, compliance, and workforce management purposes. this tool is particularly useful for remote or field workers who need to clock out from various locations.

The closeemployeegoal endpoint allows you to mark a specific performance goal as completed or closed for an individual employee in bamboohr. this action is typically used when an employee has achieved their goal or when the goal period has ended. the endpoint provides the option to include a final comment, which can be useful for summarizing the outcome or providing context for the goal closure. it's important to note that this action is irreversible, so it should be used carefully and only when you're certain that the goal should be finalized. this endpoint is particularly useful for maintaining up-to-date performance records and facilitating performance review processes within the bamboohr system.

Creates a new time tracking project in bamboohr. this endpoint allows you to set up a project with customizable settings such as billability, employee access, and associated tasks. use this when you need to establish a new project for tracking employee time, whether for client work or internal initiatives. the endpoint is particularly useful for project managers or hr administrators setting up new projects or initiatives that require time tracking. note that while you can create a project without tasks, adding tasks provides more granular time tracking capabilities.

This endpoint allows you to add a new goal for a specific employee in the bamboohr performance management system. it's used to create structured, trackable objectives that can be aligned with company strategies and shared among team members. the endpoint is particularly useful for setting up performance targets, professional development plans, or project-specific goals. it supports both simple goals and more complex objectives with multiple milestones, enabling detailed progress tracking and collaborative goal-setting within the organization.

This endpoint allows you to post a comment on a specific employee's goal within the bamboohr performance management system. it's used to provide feedback, updates, or additional information related to an employee's progress on a particular goal. the endpoint is particularly useful for managers, hr professionals, or team members who need to collaborate and communicate about goal achievement. when using this endpoint, ensure you have the necessary permissions to comment on the specified employee's goals. the comment will be immediately visible to users with access to the employee's performance records in bamboohr.

This endpoint deletes a specific row from an employee's table in bamboohr. it allows for the removal of individual entries from structured data sets associated with an employee, such as job history, education records, or certifications. the endpoint should be used when there's a need to remove incorrect or outdated information from an employee's record. it's important to note that this operation is irreversible, so it should be used with caution. this endpoint does not return the deleted data or provide a confirmation of deletion in its response, so additional verification may be necessary after calling this endpoint.

Deletes a specific employee pay stub from the bamboohr system. this endpoint should be used when there's a need to remove an incorrect or outdated pay stub from an employee's record. it permanently removes the pay stub data, so it should be used with caution and only when necessary, such as in cases of payroll errors or data cleanup. the operation cannot be undone, so it's crucial to verify the correct pay stub id before deletion. this endpoint is particularly useful for maintaining accurate payroll records and ensuring compliance with financial regulations.

The deletetimetrackingentry endpoint allows for the deletion of a specific time tracking entry from the bamboohr system. this operation is used when you need to remove an individual time tracking record, such as an incorrectly entered time-off request or work hours log. the endpoint requires the company domain and the unique identifier of the time tracking entry to be deleted. it's important to note that this operation is irreversible, so it should be used with caution. this endpoint is particularly useful for correcting errors in time tracking data or removing outdated entries, but it should not be used for bulk deletions or regular data management tasks.

Deletes a specific company benefit from the bamboohr system. this endpoint should be used when you need to remove a benefit that is no longer offered or relevant to the company. it permanently removes the benefit from the system, so it should be used with caution. once deleted, the benefit cannot be recovered, and any employees associated with this benefit may need to be updated. this operation may have implications for reporting and historical data, so it's recommended to archive or document the benefit details before deletion if needed for record-keeping purposes.

Deletes multiple clock entries from the bamboohr time tracking system. this endpoint allows administrators to remove specific time tracking records, which is useful for correcting errors, managing outdated entries, or cleaning up the time tracking data. it should be used when you need to permanently remove one or more clock entries from an employee's time tracking history. note that this operation is irreversible, so caution should be exercised when using this endpoint. the endpoint does not provide any confirmation or details about the deleted entries, so it's recommended to verify the deletion through a separate get request if necessary.

Deletes a specific file from the bamboohr system for a given company. this endpoint is used when you need to permanently remove a file from an employee's records or the company's document storage in bamboohr. it should be used with caution as the deletion is irreversible. the endpoint requires the company's subdomain and the specific file id to identify and delete the correct file. it's particularly useful for maintaining data hygiene, removing outdated or incorrect documents, or complying with data retention policies. note that this operation may be subject to user permissions within the bamboohr system, and successful deletion might depend on the file's association with other records or processes.

Deletes a specific file associated with an employee in the bamboohr system. this endpoint should be used when you need to permanently remove a document or file from an employee's record. it's particularly useful for maintaining data accuracy, complying with document retention policies, or removing outdated or incorrect files. the operation is irreversible, so caution should be exercised when using this endpoint. it does not provide any confirmation or retrieve the file content before deletion, so it's advisable to verify the correct fileid before making the call.

Deletes a specific employee training record from the bamboohr system. this endpoint is used to permanently remove a training record associated with an employee, such as completed courses, certifications, or professional development activities. it should be used when a training record needs to be removed due to errors, duplications, or when it's no longer relevant. caution should be exercised when using this endpoint, as the deletion is irreversible and may affect reporting or compliance tracking. ensure proper authorization and verification before deleting any records.

This endpoint deletes a specific goal associated with an employee in the bamboohr performance management system. it should be used when a goal is no longer relevant, has been completed, or needs to be removed from an employee's record. the operation is permanent and cannot be undone, so it should be used with caution. this endpoint is particularly useful for maintaining up-to-date and relevant goal records, especially during performance review cycles or when organizational objectives change. it does not return any data upon successful deletion, and it's important to note that it will not affect any historical performance data or completed goal achievements that may be associated with the deleted goal.

Deletes a specific comment on an employee's performance goal in the bamboohr system. this endpoint should be used when you need to remove feedback, notes, or other comments that are no longer relevant or appropriate for a particular goal. it's particularly useful for maintaining clean and up-to-date goal tracking by removing outdated or incorrect information. the deletion is permanent, so use this endpoint with caution. it does not return any content upon successful deletion, only a success status code.

Deletes multiple clock entries from the bamboohr time tracking system. this endpoint allows administrators or authorized users to remove specific time clock entries identified by their unique ids. it should be used when there's a need to correct errors, remove duplicate entries, or manage outdated records in bulk. the endpoint processes the deletion of all specified entries in a single request, improving efficiency for large-scale time tracking data management. however, it's important to note that this action is irreversible, and deleted clock entries cannot be recovered through the api.

Deletes multiple time tracking hour entries from the bamboohr system. this endpoint allows for bulk removal of hour entries, which is useful for correcting errors, removing duplicate entries, or cleaning up historical time tracking data. it should be used when you need to permanently remove specific hour entries from an employee's time tracking record. be cautious when using this endpoint, as deleted entries cannot be recovered. this tool does not provide a way to retrieve or view the entries before deletion, so it's recommended to verify the entries to be deleted using other endpoints before calling this one.

Deletes a specific training category from the bamboohr system for a given company. this endpoint should be used when you need to remove an obsolete or incorrect training category from the company's hr records. it permanently removes the category and all associated data, so it should be used with caution. the operation cannot be undone, and any training records linked to this category may be affected. ensure you have the necessary permissions and have verified the category id before deletion.

Deletes a specific training type from the bamboohr system. this endpoint is used to permanently remove a training category that is no longer needed or was created in error. it should be used with caution as the deletion is irreversible and may affect related training records. the endpoint requires the company's bamboohr subdomain and the unique identifier of the training type to be deleted. it's important to note that this action might have cascading effects on employees' training records or reports that reference the deleted training type.

The deletewebhook endpoint is used to remove a specific webhook from the bamboohr system. this operation permanently deletes the webhook configuration, stopping any further notifications for the events it was set up to monitor. use this endpoint when you need to discontinue a particular integration or clean up unused webhooks to maintain an organized webhook structure. it's important to note that this action cannot be undone, so it should be used with caution. the endpoint requires the company's domain and the unique identifier of the webhook to ensure precise targeting of the webhook to be deleted.

This endpoint allows you to adjust existing time tracking records in bamboohr. it is used to update the number of hours worked for a specific time entry, identified by its unique time tracking id. this tool is particularly useful for correcting errors in time logs, adjusting hours after the fact, or updating time records based on new information. the endpoint requires both the time tracking id and the new total hours worked, ensuring accurate and targeted updates to employee time records. it's important to note that this endpoint updates the total hours worked, not the difference from the original value.

This endpoint allows an employee to clock in and record their work start time in the bamboohr time tracking system. it captures essential information such as the start time, timezone, and optionally, the project and task being worked on, as well as the precise geolocation of the clock-in event. this tool should be used when an employee begins their work shift or returns from a break. it's particularly useful for businesses tracking remote work, field services, or requiring detailed time logs for project-based billing. the endpoint does not handle clock-out events directly; a separate call would be needed for that purpose.

Updates a specific row in a custom table for an individual employee in bamboohr. this endpoint allows you to modify various aspects of an employee's record, such as their job information, location, or organizational details. it's particularly useful for keeping employee data current when there are changes in their role, department, or other key information. the endpoint should be used when there's a need to update specific fields in a custom table that's associated with an employee, rather than modifying their core profile. it's important to note that this endpoint updates existing data and doesn't create new entries. ensure that the table and employee id exist before making the call, as the endpoint doesn't provide validation for non-existent records.

Retrieves the time off calculator information for a specific employee in bamboohr. this endpoint is used to access details about an employee's time off balances, accruals, and other related metrics. it's particularly useful for hr managers or employees themselves to check current leave balances or plan future time off requests. the calculator may include information such as available vacation days, sick leave, or other types of time off specific to the company's policies. this endpoint should be used when there's a need to programmatically access up-to-date time off information for an individual employee, which can be helpful for integrating with other systems or generating reports. note that the exact details returned may vary based on the company's bamboohr configuration and time off policies.

Retrieves a list of employees whose records have been changed in the bamboohr system for a specific company. this endpoint is useful for syncing employee data with external systems or for auditing purposes. it allows you to efficiently track updates to employee information without querying all employee records. the endpoint returns only the identifiers of changed employees, not the actual changes, so you may need to make additional api calls to fetch the updated details. use this endpoint regularly to keep your systems in sync with bamboohr data. note that the specific time range for changes and the format of the response are not provided in the given schema and may require additional parameters or documentation.

Retrieves information about changes made to a specific table in the bamboohr system for a given company. this endpoint is useful for tracking updates and modifications to employee data or other hr-related information stored in bamboohr. it allows you to monitor changes in a particular table, helping maintain data integrity and auditing purposes. use this endpoint when you need to review recent changes, sync data with external systems, or generate reports on data modifications within a specific bamboohr table. the endpoint requires specifying both the company domain and the target table name to fetch the relevant change data.

Retrieves a list of all webhooks configured for a specific company in bamboohr. this endpoint allows you to view the current webhook subscriptions, providing information about the events being monitored and the target urls where notifications are sent. use this endpoint when you need to audit existing webhooks, verify webhook configurations, or prepare for updating or deleting webhooks. it's particularly useful for maintaining and troubleshooting integrations that rely on real-time data from bamboohr. note that this endpoint only lists webhooks; it does not provide details about individual webhook events or allow for webhook creation or modification.

Retrieves aggregated performance data for a specific employee's goal within the bamboohr system. this endpoint allows users to fetch consolidated information about a particular goal, providing insights into the employee's progress and performance related to that objective. it should be used when detailed aggregate data about a specific goal is needed, such as for performance reviews, goal tracking, or progress reporting. the endpoint focuses solely on individual goal data and does not provide company-wide or team-level aggregates. note that the specific aggregated metrics returned may vary based on the goal type and settings within your bamboohr environment.

Retrieves aggregated goal information for a specific employee within a company's bamboohr system. this endpoint provides a comprehensive overview of an employee's goals, including a list of all goals, goal type counts, and goal comment counts. it's particularly useful for managers or hr professionals who need a quick summary of an employee's performance objectives and progress. the tool should be used when a high-level view of an employee's goal-related activities is required, such as during performance reviews or goal-setting sessions. it does not provide detailed information about individual goals or allow for goal modifications.

Retrieves aggregated performance goal data for a specific employee within a company's bamboohr system. this endpoint provides a comprehensive summary of an employee's goals, potentially including metrics such as goal completion rates, progress status, and overall performance against set objectives. it's particularly useful for managers and hr professionals who need a quick overview of an employee's goal-related performance without diving into individual goal details. the aggregated data can be valuable for performance reviews, goal-setting sessions, or generating reports on employee progress. note that this endpoint focuses on summarized data and may not provide granular details about each individual goal.

Retrieves aggregated information about an employee's goals within the bamboohr performance management system. this endpoint provides a summary of goal-related data for a specific employee, which may include metrics such as goal completion rates, progress status, or overall performance indicators. it's particularly useful for managers or hr professionals who need a quick overview of an employee's goal achievement without delving into individual goal details. the aggregated data can be valuable for performance reviews, progress tracking, or identifying areas where an employee may need additional support or recognition. note that this endpoint focuses on summarized data and may not provide exhaustive details about each individual goal.

Retrieves a list of dependents for all employees in the company. this endpoint provides comprehensive information about employee dependents, which may include family members, beneficiaries, or other individuals associated with employees for hr purposes such as benefits administration or emergency contacts. it's particularly useful for generating reports, updating benefits information, or performing company-wide dependent audits. the endpoint returns data for all employees, so it should be used cautiously and in compliance with data privacy regulations. note that this endpoint does not support filtering or pagination, so it may return a large amount of data for companies with many employees and dependents.

Retrieves a specific employee file from the bamboohr system. this endpoint allows you to fetch individual documents or records associated with employees, such as contracts, performance reviews, or personal information forms. it should be used when you need to access or download a particular file for an employee. the endpoint requires the company's bamboohr subdomain and the unique file identifier to locate and retrieve the correct file. note that this endpoint only retrieves the file content; it does not provide metadata about the file or list multiple files. ensure you have the necessary permissions to access the requested file, as bamboohr's access controls may restrict file retrieval based on user roles.

Retrieves a specific file associated with an employee from the bamboohr system. this endpoint allows you to access individual documents or files that have been uploaded to an employee's record, such as resumes, contracts, or performance reviews. it should be used when you need to fetch a particular file for viewing, downloading, or processing. the endpoint requires precise identification of the company, employee, and file, ensuring secure and accurate retrieval of sensitive hr documents. it's important to note that this endpoint only retrieves the file; it does not provide capabilities for uploading, modifying, or deleting files. access to files may be subject to user permissions within the bamboohr system.

Retrieves an employee's photo from the bamboohr system in a specified size. this endpoint is used to fetch visual representations of employees, which can be useful for directories, profiles, or other hr-related applications that require employee images. the tool allows for flexibility in photo size, enabling developers to retrieve appropriately sized images for different use cases, such as thumbnails or full-size profile pictures. it should be used when an application needs to display or process an employee's photo. note that the availability and quality of photos depend on what has been uploaded to the bamboohr system for each employee.

Retrieves the withholding information for a specific employee within a company's bamboohr system. this endpoint allows hr professionals and authorized personnel to access tax withholding details, which are crucial for payroll processing and tax reporting. it provides up-to-date information on an employee's tax withholding status, including federal, state, and local tax elections. use this endpoint when you need to review or verify an employee's current withholding information, such as during payroll runs, annual reviews, or when an employee requests changes to their withholding. the endpoint returns only the most recent withholding data and does not provide historical information or the ability to modify withholding details.

Retrieves detailed information about a specific employee's direct deposit account within a bamboohr company instance. this endpoint is used to access sensitive financial information, such as bank account details and routing numbers, associated with an employee's payroll. it should be used when there's a need to view or verify an employee's direct deposit setup, such as during payroll processing or when an employee requests to confirm their banking information. the endpoint returns read-only data and does not allow modifications to the account information. it's important to note that this endpoint should only be accessed by authorized personnel with appropriate permissions due to the sensitive nature of the data involved.

Retrieves detailed pay stub information for a specific employee within a company's bamboohr system. this endpoint allows hr professionals or authorized personnel to access an individual employee's pay details, including earnings, deductions, and net pay for a particular pay period. it's particularly useful for payroll verification, addressing employee inquiries about their compensation, or generating reports. the endpoint should be used when specific, detailed pay information is needed for an individual employee. it does not provide aggregate payroll data or modify any information. note that access to this sensitive data is likely to be restricted to users with appropriate permissions within the bamboohr system.

Retrieves the unpaid pay stubs for a specific employee within a company's bamboohr account. this endpoint is used to access detailed information about an employee's earnings that have not yet been paid out, which is crucial for payroll processing and financial record-keeping. it should be used when there's a need to review or verify an employee's pending compensation before the actual payment is made. the endpoint provides up-to-date information on unpaid wages, bonuses, or other forms of compensation, but does not include historical data for already paid stubs. it's particularly useful for payroll administrators, finance teams, or integrated payroll systems that need to ensure accurate and timely payment processing.

Retrieves a specific time tracking record from bamboohr based on the provided company domain and record id. this endpoint allows you to fetch detailed information about a single time entry, including the employee, date, hours worked, and any associated metadata. it's particularly useful for auditing time entries, generating reports, or displaying detailed time tracking information in custom interfaces. the endpoint should be used when you need to access or verify the details of a specific time tracking record. note that this endpoint only retrieves data and does not modify any existing records.

Retrieves a list of applications submitted through the bamboohr applicant tracking system (ats). this endpoint allows hr personnel and recruiters to access and review all job applications in a centralized manner. it's particularly useful for managing the hiring process, tracking candidate progress, and generating reports on recruitment activities. the endpoint returns detailed information about each application, which may include applicant details, applied position, application date, and current status. use this endpoint when you need to fetch application data for review, analysis, or integration with other hr systems. note that the response may be paginated for large datasets, and additional parameters for filtering or sorting may be available but are not specified in the given schema.

Retrieves detailed information about a specific job application from bamboohr's applicant tracking system. this endpoint allows you to access comprehensive data related to a single application, including applicant details, application status, and any custom fields associated with the application process. it's particularly useful when you need to review or process individual applications, such as during candidate evaluation or interview scheduling. the endpoint provides a snapshot of the application at the time of the request, reflecting the most current information available in the system. note that this endpoint is read-only and does not allow modification of application data.

Retrieves a specific clock entry for an employee from the bamboohr time tracking system. this endpoint allows you to fetch detailed information about a single clock-in or clock-out record, including timestamps and any associated metadata. use this when you need to review or verify a particular time entry for an employee, such as for payroll processing, attendance verification, or dispute resolution. the endpoint provides access to historical time tracking data, but it does not allow modification of existing entries or creation of new ones. note that the accessibility of clock entries may be subject to company-specific permissions and retention policies.

Retrieves detailed information about a specific company benefit offered by an organization using bamboohr. this endpoint allows hr administrators or integrated systems to fetch comprehensive data about a particular benefit, such as health insurance plans, retirement options, or other employee perks. it's useful for reviewing benefit details, verifying information, or displaying benefit specifics to employees. the endpoint requires the company's bamboohr subdomain and the unique identifier of the benefit, ensuring accurate and targeted data retrieval. note that this endpoint only provides information about the benefit itself and does not include employee enrollment data or personal information.

Retrieves a specific daily time tracking entry for an employee in bamboohr. this endpoint allows you to fetch detailed information about a single day's time tracking record, including clock-in and clock-out times, total hours worked, and any associated metadata. it's particularly useful when you need to review or verify an employee's time entry for a specific date. the endpoint requires the company domain, employee id, and the unique identifier of the daily entry to ensure accurate and secure data retrieval. use this endpoint when you need to access or display detailed time tracking information for auditing, payroll processing, or employee time management purposes.

Retrieves a comprehensive list of company-wide benefits offered by the organization as configured in bamboohr. this endpoint provides details about various benefit programs such as health insurance plans, retirement options, paid time off policies, and other perks available to employees. it's particularly useful for hr managers and system integrators who need to access or sync the company's benefit information across different platforms. the endpoint should be used when you need an overview of all benefits at the company level, rather than benefits assigned to specific employees. note that this endpoint does not provide individual employee enrollment information or personalized benefit details.

Retrieves a list of company benefit types available in the specified bamboohr company account. this endpoint allows hr administrators and integrated systems to fetch information about the various benefit categories or types that the company offers to its employees. it's useful for populating dropdown menus in benefits enrollment forms, generating reports on benefit offerings, or syncing benefit type data with other hr systems. the endpoint provides a comprehensive view of the benefit structure within the organization but does not include details about specific benefit plans or employee enrollments.

Retrieves employee benefit information based on specified filters. this endpoint allows hr professionals and benefit administrators to query and access employee benefit data using various criteria such as employee id, company benefit plan id, or enrollment status effective date. it is particularly useful for tasks like auditing benefit enrollments, managing open enrollment periods, or generating reports on benefit plan participation. the endpoint requires at least one filter to be specified and can combine multiple filters for more precise queries. it should be used when specific employee benefit information is needed, rather than for bulk data retrieval. note that this endpoint only provides filter-based access to benefit data and does not support creating, updating, or deleting benefit information.

Retrieves metadata about available fields in the bamboohr api for a specific company. this endpoint provides essential information about the structure and attributes of employee data that can be accessed or manipulated through other api calls. it should be used when you need to understand the available fields, their data types, and any constraints or formatting requirements. this information is crucial for constructing accurate queries or updates to employee records. the endpoint does not return actual employee data; it only provides metadata about the fields themselves.

Retrieves metadata information about the tables available in the bamboohr system for a specific company. this endpoint is essential for developers and integrators who need to understand the structure of the bamboohr data model. it provides details about the available tables, which can be used to plan data retrieval, reporting, and integration strategies. the metadata likely includes table names, field names, and potentially data types or other structural information. this tool should be used when initializing a new integration or when updates to the bamboohr system might have changed the data structure. it's particularly useful for dynamic integrations that need to adapt to changes in the bamboohr schema. note that this endpoint doesn't return the actual data within the tables, only their structural information.

Retrieves metadata about users within a specific company's bamboohr instance. this endpoint is useful for obtaining information about all users in the system, which can be valuable for user management, reporting, and integration purposes. it provides a comprehensive list of users and their associated metadata, allowing for efficient bulk retrieval of user information. this endpoint should be used when you need to gather data about multiple users simultaneously or when you require an up-to-date list of all users in the bamboohr system for a given company.

Retrieves a list of employees who are currently out of office or on leave within your organization. this endpoint is part of bamboohr's time off management feature and provides real-time information about employee absences. use this endpoint to get an overview of current staff availability, which can be helpful for resource planning, scheduling, or maintaining an up-to-date company-wide calendar. the endpoint returns data for all types of absences, including vacation, sick leave, and other approved time-off categories. note that this endpoint only provides current "who's out" information and does not offer historical or future absence data.

Retrieves a specific timesheet for a given employee within a bamboohr company environment. this endpoint allows you to fetch detailed time tracking information for a particular timesheet, identified by its unique id, associated with a specific employee. it's useful for reviewing an employee's work hours, verifying time entries, or gathering data for payroll processing. the endpoint should be used when you need to access or analyze individual timesheet data, rather than summary or aggregate time tracking information. note that this endpoint retrieves data for a single timesheet only; for bulk timesheet data or time tracking summaries, you may need to use different endpoints or make multiple calls.

Retrieves the benefit coverages information for employees within a specific company in bamboohr. this endpoint allows hr administrators and authorized personnel to access detailed data about the various benefit plans and coverage options available to employees. it provides a comprehensive overview of the company's benefit offerings, which may include health insurance, dental plans, vision coverage, life insurance, and other employee benefits. use this endpoint when you need to review, audit, or report on the current benefit coverage landscape for the entire organization. the returned data can be useful for benefits administration, open enrollment planning, and ensuring compliance with company policies and regulations.

Retrieves detailed information about a specific payroll deduction by its id for a given company in bamboohr. this endpoint allows hr administrators and payroll managers to access comprehensive data about individual deductions, such as type, amount, frequency, and associated employee information. it's particularly useful when reviewing or auditing payroll deductions, preparing reports, or addressing employee inquiries about specific deductions. the endpoint provides up-to-date information but does not allow modifications to the deduction data.

Retrieves a comprehensive list of all deduction types configured in the bamboohr system for a specific company. this endpoint is crucial for benefits administrators and payroll managers who need to review or audit the various deduction categories set up in their bamboohr instance. it provides a complete overview of all possible deductions that can be applied to employee paychecks, such as health insurance premiums, retirement contributions, or other benefits-related deductions. this tool should be used when a full inventory of deduction types is required, for example, during benefit enrollment periods, payroll reconciliation, or when updating company-wide benefit policies. note that this endpoint does not provide individual employee deduction information, but rather the types of deductions available in the system.

Retrieves a list of benefit groups for a specific company in bamboohr. this endpoint allows you to access information about the various benefit groups set up within your organization, which can be crucial for managing employee benefits and understanding the structure of your company's benefit offerings. it's particularly useful when you need to review or audit the benefit groups available to employees, or when integrating benefit information with other hr systems. the endpoint doesn't support creating, updating, or deleting benefit groups, nor does it allow for enrolling employees or changing benefit statuses. use this endpoint when you need a comprehensive overview of all benefit groups in your bamboohr instance.

Retrieves a list of employees associated with benefit groups within a specific bamboohr company instance. this endpoint is useful for hr administrators and systems integrators who need to access or audit employee benefit group assignments. it provides a comprehensive view of how employees are categorized for benefits purposes, which can be essential for managing enrollment periods, analyzing benefit distribution, or synchronizing data with other hr systems. the endpoint should be used when you need an up-to-date snapshot of benefit group memberships across the organization. note that this endpoint only provides read access and cannot be used to modify benefit group assignments. the returned data may include employee ids, names, and their associated benefit group information, but the exact structure of the response should be verified in the api documentation.

Retrieves a list of benefit group plans for a specified company in bamboohr. this endpoint is used to fetch information about the various benefit plans associated with different groups within the organization. it's particularly useful for hr administrators and benefits managers who need to review or manage the benefit offerings across the company. the endpoint returns details about each benefit group plan, which may include plan names, coverage types, eligibility criteria, and other relevant information. use this endpoint when you need a comprehensive overview of the benefit structure within the company or when preparing for benefits enrollment periods. note that the specific details returned may vary based on the company's configuration and the user's access permissions within bamboohr.

Retrieves the costs associated with benefit group plans for a specific company in bamboohr. this endpoint provides detailed financial information about employee benefit plans, including premiums, contributions, and other related expenses. it is particularly useful for hr managers and finance teams who need to analyze and manage benefit costs across different employee groups. the endpoint should be used when you need to review or report on the current cost structure of your company's benefit plans. it does not modify any data and is intended for read-only operations. note that the response may not include historical cost data or future projections, focusing instead on current cost information.

Retrieves a list of benefit plans available for the specified company in bamboohr. this endpoint allows you to fetch comprehensive information about the various employee benefit plans offered by the organization, such as health insurance, retirement plans, and other perks. it should be used when you need to review or analyze the benefit offerings for a specific company within bamboohr. the endpoint provides a snapshot of current benefit plans and does not include historical data or employee enrollment information. keep in mind that the level of detail in the response may vary depending on the company's configuration and data availability in bamboohr.

Retrieves detailed information about benefit plan coverages for employees within a specific bamboohr company environment. this endpoint provides comprehensive data on various benefits and coverages offered by the company, such as health insurance, retirement plans, and other employee benefits. it should be used when you need to access or review the current benefit plans and coverage details for employees. the endpoint is particularly useful for hr administrators, benefits coordinators, or integration systems that need to synchronize benefit information with other platforms. note that this endpoint only provides read access to the benefit plan coverage data and cannot be used to modify or update this information.

Retrieves detailed information about a specific employee plan within a company's bamboohr system. this endpoint allows hr professionals and authorized personnel to access individual plan details, which may include benefits information, compensation arrangements, or other work-related agreements. it's particularly useful when reviewing or updating an employee's plan, during performance evaluations, or when making changes to employee benefits. the endpoint requires the company's unique domain identifier and the specific plan id to fetch the correct information. while it provides access to plan details, it does not allow modifications to the plan through this get request. for any changes or updates to the plan, a separate endpoint (likely a put or patch request) would be necessary.

Retrieves a list of locations associated with the applicant tracking system for a specific bamboohr company account. this endpoint is useful for obtaining information about the various locations or offices where job openings may be available or where applicants might be considered for placement. it can be used to populate location dropdown menus in job application forms or to filter job postings by location. the endpoint provides a comprehensive view of all locations configured in the company's applicant tracking system, which is particularly valuable for organizations with multiple office locations or those offering remote work options. note that this endpoint only returns location data and does not provide any information about specific job openings or applicants associated with these locations.