com.mcparmory/bamboohr

Adds a comment to a specific job application in the Applicant Tracking System. Requires the API key owner to have access to ATS settings.

Adds a new comment to a specific goal belonging to the given employee. Returns the newly created comment object, including its assigned ID.

Creates a balance adjustment for a specific time off type on an employee's account, recorded as an override history entry. Not applicable to discretionary (unlimited) time off types.

Assigns a specific set of employees to a break policy, fully replacing all existing employee assignments with the provided list.

Assigns one or more time off policies to an employee, with accruals beginning on the specified start date for each policy. Passing a null accrual start date for a policy removes that existing assignment; returns the full updated list of assigned policies on success.

Assigns one or more employees to an existing break policy, adding them to the policy's membership without affecting any previously assigned employees.

Assigns one or more time off policies to an employee, with accruals beginning on the specified start date for each policy. Returns the employee's full current list of assigned policies, including manual and unlimited policy types.

Creates new timesheet clock entries or updates existing ones in a single bulk operation. Entries containing an existing ID are updated; entries without an ID are created as new records.

Creates new timesheet hour entries or updates existing ones in a single bulk operation. Entries containing an existing ID are updated; entries without an ID are created as new records.

Records a clock-in entry for an employee, defaulting to the current server time. To log a historical entry, supply a date, start time, and timezone, and optionally associate the entry with a project, task, break, or note.

Records a clock-out entry for a currently clocked-in employee, defaulting to the current server time. To log a historical clock-out, supply a date, end time, and timezone.

Closes an employee's goal by transitioning it to closed status, optionally recording a comment at the time of closure. Note: cascading goals that have visible child goals cannot be closed.

Creates a new break and associates it with the specified break policy. Configure the break's name, pay status, duration, and availability rules to control when employees can take it.

Creates a new break policy for time tracking compliance, optionally including break definitions and employee assignments in a single request.

Submit a new candidate application for a specific job opening in the Applicant Tracking System. Requires ATS settings access; only fields mandated by the target job's standard questions need to be provided beyond the three required fields.

Creates a new employee record with at minimum a first and last name; additional fields such as payroll, contact, and job details can be included using any valid employee field name discoverable via the list-fields endpoint. Employees added to a Trax Payroll-synced pay schedule require a full set of payroll-related fields including SSN/EIN, compensation, and location details.

Creates a new dependent record associated with a specific employee, capturing personal, demographic, and address details. The employee must exist, and sensitive fields like SSN and SIN are accepted as plain text and stored encrypted.

Creates one or more employee file categories by accepting a list of category names. An empty payload succeeds without creating anything; duplicate or empty names return an error.

Creates a new performance goal for a specified employee, including due dates, completion tracking, milestones, and sharing with other employees.

Appends a new row to a specified tabular data section of an employee record, such as job information or compensation history. Submit field name/value pairs in JSON or XML to record a new entry with an effective date and relevant attributes.

Adds a new row to a specified table in an employee's record, such as job information or compensation history. Accepts row data in JSON or XML format with an optional effective date and relevant field values.

Creates a new training record for a specified employee, logging completion date, training type, and optional details such as instructor, hours, credits, cost, and notes. The API key owner must have permission to add training records for the target employee.

Creates one or more company file categories in a single request. Returns 400 if any name is empty or already exists, 403 if the caller lacks permission or a name is reserved, and 200 with no changes if the payload is empty.

Creates a new job opening in the Applicant Tracking System (ATS). Requires ATS settings access; use the list_company_locations and list_hiring_leads endpoints to retrieve valid IDs for location and hiring lead fields. Returns the new job opening ID on success.

Creates a new time tracking project with optional task-level tracking and employee access controls. Returns the created project including its ID, tasks, and employee access list when access is restricted.

Creates a single time tracking hour record for an employee. Use this endpoint for one-off entries; for bulk imports use the batch upsert endpoint.

Records a time off history entry for an employee, either logging usage against an approved time off request or applying a manual balance adjustment. The entry type determines which additional fields are required.

Creates a time off request for an employee with an initial status of approved, denied, or requested. Approved and denied requests are recorded directly without triggering approval notifications; supplying a previousRequest ID cancels the original request and replaces it with this one.

Creates a new training category to organize training content. Requires training settings access and returns the newly created TrainingCategory on success.

Creates a new training type with the specified configuration, including optional renewal schedules, hiring requirements, and completion permissions. Requires training settings access; when renewable is true, frequency must be provided, and dueFromHireDate is only applicable when required is true.

Soft-deletes a time tracking break by its unique identifier, permanently removing it from any associated break policies.

Permanently deletes a break policy by its unique identifier. All associated breaks and employee assignments linked to the policy are also removed.

Permanently deletes one or more timesheet clock entries by their unique IDs. This operation is idempotent, so submitting IDs for already-deleted entries will not cause errors or require retries.

Permanently deletes a company file by its unique identifier. Requires write access to company files; returns 404 if the file is not found or 403 if the caller lacks sufficient permissions.

Permanently deletes a specific file associated with an employee record. Returns 200 even if the file was already deleted (idempotent), 404 if the file is not linked to the specified employee, and 403 if the caller lacks permission or the file is managed by BambooPayroll.

Permanently deletes a specific goal associated with an employee. The goal must belong to the specified employee; returns 204 with no response body on success.

Permanently removes a specific row from a named tabular dataset associated with an employee. Deletion will fail if the row has pending approval changes (409) or is tied to an active pay schedule (412).

Permanently deletes a specific comment from an employee's goal. The comment must belong to the specified goal, which must be associated with the specified employee. Returns 204 with no response body on success.

Permanently deletes one or more timesheet hour entries by their unique IDs. This operation is idempotent, so submitting IDs for already-deleted entries will not cause errors or require retries.

Permanently deletes a time tracking record and all of its associated revisions by ID. Note that both not-found and invalid ID cases return a 400 invalid-argument response for backward compatibility.

Permanently deletes an existing training category by its unique identifier. The API key owner must have access to training settings to perform this action.

Permanently deletes an existing employee training record by its unique ID. The API key owner must have view and edit permissions for both the associated employee and training type.

Permanently deletes an existing training type by its ID, requiring training settings access. All employee trainings associated with this type must be removed before this deletion will succeed.

Permanently deletes a webhook associated with the authenticated user's API key. Returns 403 if the webhook belongs to a different API key, or 404 if the webhook does not exist.

Downloads the raw content of a company file by its ID, with the response including the appropriate MIME type and original filename as an attachment. Access is granted if the file or its category is shared with employees, shared directly with the requesting user, or the user holds view permission on the file section.

Downloads the binary content of a specific file attached to an employee record, returning it as an attachment with the appropriate MIME type. Returns 403 if access to the employee or file section is denied, and 404 if the file does not exist or is archived.

Retrieves full details for a single job application, including applicant information, job details, screening questions and answers, and status history. Requires the API key owner to have access to ATS settings.

Retrieves the full details of a specific time tracking break by its unique identifier, including its name, duration, paid status, and availability configuration.

Retrieves a single break policy by its unique identifier. Optionally includes counts of associated employees and breaks for summary reporting.

Retrieves the company's basic profile information, including legal name, display name, primary address, and contact phone number. Data is sourced from active payroll client metadata for BambooHR Payroll companies, or from account settings for all others.