Connectors

HR & People

BambooHR

HR platform: employees, time off, benefits, and reporting data
BambooHR API referenceAPI checked August 16, 2026
Signs in with
Connection fields
Runs on
Cloud or On-Prem Worker
Operations
302
Ready-made triggers
0

Connect BambooHR

  1. In Neblex open Connect › Connections and click New Connection.
  2. Search for BambooHR and give the connection a clear name.
  3. Fill in the fields. Secret values are encrypted and never shown again.
  4. Click Test, then Create Connection.
FieldWhat to enter
Company domainRequiredThe subdomain in {company}.bamboohr.com.
API keyOptionalSecretBambooHR API key, sent as the HTTP Basic username with password x.
OAuth access tokenOptionalSecretOAuth 2.0 Bearer access token for OAuth-only or dual-auth routes.

Use it in a flow

  1. Open a flow, open the node library and search for BambooHR.
  2. Drag it onto the canvas and choose an Operation and your connection.
  3. Map the operation's fields from earlier steps, or click Map with Matt.
  4. Use Test this step to see what it returns, then save.

To start a flow from BambooHR without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if BambooHR can send webhooks, a Webhook trigger receives them at its own URL.

Operations

302 operations in 31 groups. Each one is a step you can add to a flow.

Account Information17
Get all currency typesgetCurrencyTypesGETReturns a JSON array of supported currency catalog entries.
Get All ProvincesgetAllProvincesGETReturns a flat list of all states and provinces across every country.
Get company propertiesgetCompanyPropertiesGETGet company properties including ID, name, domain, and base API URL.
Get CountriesgetCountriesGETReturns a JSON array of every country in the catalog, or a single country object when isoCode is supplied.
Get Country by IDgetCountryGETReturns a single country from the catalog as a JSON object, identified by its numeric id.
Get Currency Conversion RatesgetCurrencyConversionsGETReturns the latest currency conversion rate snapshot for a single base currency.
Get timezone by IDgetTimezoneGETRetrieves a single timezone by its numeric ID.
Get timezone by ZIP codegetTimezoneByZipGETRetrieves the timezone for a US ZIP code.
List Bank HolidayslistBankHolidaysGETReturns global bank holiday reference dates (US federal and related bank holidays maintained by BambooHR), not company-configured holidays.
List FieldslistFieldsGETReturns a list of all employee fields available in the account, including field ID, display name, data type, and whether the field is deprecated.
List IndustriesgetIndustriesGETReturns every industry in BambooHR's reference data as a JSON array.
List List FieldslistListFieldsGETReturns details for all list fields in the account.
List states and provinces for a country by Country IDgetProvincesByCountryGETReturns the list of states or provinces for the specified country, sorted alphabetically by abbreviation (options[].label).
List Tabular FieldslistTabularFieldsGETReturns a list of all tabular (table-based) fields available in the account.
List timezoneslistTimezonesGETRetrieves a paginated list of timezones.
List UserslistUsersGETReturns all users for the company, optionally filtered by status.
Update List Field ValuesupdateListFieldValuesPUTCreate, update, or archive options for a list field.
Alerts5
Create Alert ConfigurationcreateAlertConfigurationPOSTCreates an alert configuration for the authenticated company from one of BambooHR's alert templates, and returns the stored configuration, including its server-assigned id, as a single...
Get Alert ConfigurationgetAlertConfigurationGETReturns one alert configuration the company has set up: which alert template it uses, when it runs, who receives it, and any custom subject, message, or list-value filters.
List Alert ConfigurationslistAlertConfigurationsGETReturns every alert configuration the company has set up: which alert template each one uses, when it runs, who receives it, and any custom subject, message, or list-value filters.
List Alert TemplateslistAlertTemplatesGETReturns the catalog of alert templates that company alert configurations are built from.
Replace Alert ConfigurationupdateAlertConfigurationPUTOverwrites the alert configuration identified by {id} and returns the stored configuration as a single JSON object.
Applicant Tracking10
Create CandidatecreateCandidatePOSTCreate a new candidate application for a job opening.
Create Job Application CommentcreateApplicationCommentPOSTAdd a comment to an application.
Create Job OpeningcreateJobOpeningPOSTCreate a new job opening.
Get Applicant StatuseslistApplicantStatusesGETGet a list of applicant statuses configured for the company.
Get Company LocationslistAtsLocationsGETGet all company locations available for use when creating a job opening.
Get Hiring LeadslistHiringLeadsGETGet the list of employees who can be assigned as a hiring lead when creating a new job opening.
Get Job Application DetailsgetJobApplicationGETGet the full details of a single application including applicant info, job details, questions and answers, and status history.
Get Job ApplicationslistJobApplicationsGETGet a list of applications.
Get Job SummarieslistJobSummariesGETGet a list of job opening summaries.
Update Applicant StatusupdateApplicantStatusPOSTUpdate the status of an application.
Benefits10
Create Employee DependentcreateDependentPOSTCreates a new dependent record for an employee.
Get Employee DependentgetDependentGETReturns the details of a single employee dependent by their dependent ID.
List Benefit CoverageslistBenefitCoveragesGETReturns all benefit coverage levels configured in the company, such as Employee Only, Employee + Spouse, and Employee + Family.
List Benefit Deduction TypeslistBenefitDeductionTypesGETReturns all benefit deduction types available in the system.
List Company BenefitslistCompanyBenefitsGETReturns all active (non-deleted) company benefit plans for the account.
List Employee BenefitslistEmployeeBenefitsGETReturns current and scheduled-future benefit enrollment records, grouped by employee.
List Employee DependentslistDependentsGETReturns employee dependents for the company.
List Member Benefit EventslistMemberBenefitEventsGETReturns benefit enrollment events for all employees and their dependents over the past year, organized by member.
List Member BenefitslistMemberBenefitsGETReturns a paginated list of benefit enrollment records for all members (employees and dependents) in the company for a given calendar year.
Update Employee DependentupdateDependentPUTReplaces all fields on an existing employee dependent record.
Change Tracking2
Get Changed Employee IDsgetChangedEmployeesGETReturns a list of employee IDs that have changed since the given timestamp.
Get Changed Employee Table DatagetChangedTableDataGETReturns table data for employees that have changed since the given timestamp.
Company Files6
Create Company File CategorycreateCompanyFileCategoryPOSTCreates one or more company file categories.
Delete Company FiledeleteCompanyFileDELETEPermanently removes a company file and its associated storage.
Get Company FilegetCompanyFileGETDownloads a company file by its ID.
Get Company Files and CategorieslistCompanyFilesGETReturns all company file categories and the files within each category that the requesting user is permitted to see.
Update Company FileupdateCompanyFilePOSTUpdates metadata for an existing company file.
Upload Company FileuploadCompanyFilePOSTUploads a file to a company file category.
Company Profile3
Get Company Profile IntegrationsgetCompanyProfileIntegrationsGETReturns the list of integration feature identifiers currently enabled for the company.
Update company display nameupdateCompanyDisplayNamePUTUpdates the company display name.
Update company information (phone, address, legal name)updateCompanyInformationPATCHUpdates legal name, phone, and/or address for the company (application/merge-patch+json).
Compensation3
Get company equity settingsgetEquitySettingsGETRetrieves company-level equity settings including calculation type, valuation, shares, pricing, and vesting-related configuration.
List available compensation toolslistCompensationToolsGETReturns the list of available compensation tools/settings for the company, including Levels & Bands, Compensation Benchmarking, Compensation Planning, and Total Rewards.
Update company equity settingsupdateEquitySettingsPUTUpdates company-level equity settings including calculation type, valuation, shares, pricing, and vesting-related configuration.
Compensation Benchmarking11
Create Compensation BenchmarkcreateBenchmarkPOSTCreates a new compensation benchmark for a specific company job title (and optionally a specific job location).
Create Compensation Benchmark SourcecreateBenchmarkSourcePOSTCreates a new benchmark source the company can attach to its benchmarks.
Delete Compensation BenchmarkdeleteBenchmarkDELETEPermanently removes the compensation benchmark identified by id.
Delete Compensation Benchmark SourcedeleteBenchmarkSourceDELETEDeletes a benchmark source together with all benchmarks currently attached to it.
Export Compensation Benchmark DetailsexportBenchmarkDetailsGETReturns a CSV export of the compensation benchmark detail view for a single job, optionally scoped to a specific location.
Get Compensation Benchmark DetailsgetBenchmarkDetailsGETReturns detailed benchmark data for a single company job title, optionally scoped to a specific location.
Import Compensation Benchmarks From CSVimportBenchmarksPOSTParses a CSV of compensation benchmarks uploaded as multipart/form-data and returns the parsed rows together with a suggested column-to-field mapping.
List Compensation Benchmark SourceslistBenchmarkSourcesGETReturns every enabled benchmark source configured for the company.
List Compensation BenchmarkslistBenchmarksGETReturns every job/location pair the company tracks for compensation benchmarking.
Update Compensation BenchmarkupdateBenchmarkPUTUpdates an existing compensation benchmark identified by id.
Update Compensation Benchmark SourcesupdateBenchmarkSourcesPUTUpdates the name and sort order of one or more existing benchmark sources in a single call.
Compensation Planning28
Add cycle adminsaddCycleAdminsPOSTAdd one or more cycle admins by internal employee IDs.
Add employees to cycleaddCycleEmployeesPOSTAdd employees to a compensation planning cycle.
Complete compensation planning cyclecompletePlanningCyclePUTComplete a compensation planning cycle and finalize employee compensation records.
Create compensation planning cyclecreatePlanningCyclePOSTCreate a new compensation planning cycle with default settings.
Delete compensation planning cycledeletePlanningCycleDELETEDelete a compensation planning cycle.
Export compensation planning cycle worksheet to CSVexportCycleWorksheetGETDownload compensation planning worksheet data as a UTF-8 CSV (Excel-friendly BOM).
Get change communication letter detailsgetChangeCommGETGet change communication letter details for the compensation planning cycle.
Get compensation planning approval flowsgetApprovalFlowsGETGet approval flows for the compensation planning cycle (grouped by department by default).
Get compensation planning cycle budgetsgetCycleBudgetsGETGet budget guidelines and breakdown for the compensation planning cycle.
Get compensation planning cycle detailsgetPlanningCycleGETGet compensation planning cycle details and currency settings for a cycle.
Get compensation planning cycle summarygetCycleSummaryGETGet compensation planning cycle summary (progress, stats).
Get compensation planning cycle worksheetgetCycleWorksheetGETGet compensation planning worksheet details for the cycle (recommendations, approvals, or overview context).
Import budget breakdownimportBudgetBreakdownPOSTImport budget breakdown from structured data and apply to allocations.
Launch compensation planning cyclelaunchPlanningCyclePUTLaunch a compensation planning cycle.
List compensation planning cycle adminslistCycleAdminsGETList compensation planning cycle admins.
List compensation planning cycleslistPlanningCyclesGETList all compensation planning cycles for the company, including status and employee counts.
List employees in compensation planning cyclelistCycleEmployeesGETList employees in the compensation planning cycle (picker data: company roster and membership).
Remove cycle adminremoveCycleAdminDELETERemove a cycle admin by internal employee ID.
Remove employees from cycleremoveCycleEmployeesDELETERemove employees from a compensation planning cycle.
Remove from approval flowremoveFromApprovalFlowDELETERemove an employee from all approval chains for a specific cycle.
Save budget breakdownsaveBudgetBreakdownPUTSave budget breakdown for a compensation planning cycle.
Save budget guidelinessaveBudgetGuidelinesPUTSave budget guidelines for a compensation planning cycle.
Save change comm templatesaveChangeCommTemplatePUTSave the change communication email template for a compensation planning cycle.
Save recommendationssaveRecommendationsPOSTSave compensation recommendations for an employee in a cycle.
Send recommendations to next stagesendRecommendationsPOSTSend recommendations to the next approval stage for a specific approval flow template.
Set final approversetFinalApproverPOSTSet or update the final approver for all approval flows in a cycle.
Update approval flowupdateApprovalFlowPUTUpdate an approval flow for a compensation planning cycle.
Update compensation planning cycleupdatePlanningCyclePUTUpdate compensation planning cycle details and currency settings.
Custom Reports4
Get Legacy Report Field MapgetLegacyReportFieldMapGETReturns the mapping from the field identifiers the deprecated Reports Get Company Report (get-company-report) endpoint emitted to the field names the Custom Reports and Datasets endpoints...
Get Legacy Report ID MapgetLegacyReportIdMapGETReturns a mapping from legacy custom report IDs to the new report IDs created by the report migration.
Get Report by IDgetCustomReportGETExecutes a saved custom report and returns its data using the report's configured fields and filters.
List ReportslistCustomReportsGETReturns a paginated list of saved custom reports available in the account.
Datasets4
Get Data from Dataset (v2)getDatasetDataPOSTQueries the named dataset and returns the matching rows.
Get Field Options (v1.2)getDatasetFieldOptionsPOSTReturns the allowed values for one or more fields in a dataset, for use as filter values when querying data via "Get Data from Dataset (v2)".
Get Fields from Dataset (v1.2)getDatasetFieldsGETReturns a paginated list of field descriptors for the specified dataset.
List Datasets (v1.2)listDatasetsGETReturns the catalog of datasets available for querying via the Datasets API.
Employee Files6
Create Employee File CategorycreateEmployeeFileCategoryPOSTCreates one or more employee file categories (not company file categories).
Delete Employee FiledeleteEmployeeFileDELETEPermanently deletes an employee file.
Get Employee FilegetEmployeeFileGETDownloads the binary content of an employee file as an attachment.
List Employee FileslistEmployeeFilesGETLists the file categories and files visible to the caller for the specified employee.
Update Employee FileupdateEmployeeFilePOSTUpdates metadata for an existing employee file.
Upload Employee FileuploadEmployeeFilePOSTUploads a file to an employee's file section.
Employee Tables4
Create Table Row (v1.1)createTableRowPOSTAdd a new row to the specified employee table using the v1.1 table-row creation endpoint.
Delete Employee Table RowdeleteTableRowDELETEDeletes a specific row from an employee's tabular data.
Get Employee Table DatagetEmployeeTableGETReturns all rows for a given employee and table combination.
Update Table Row (v1.1)updateTableRowPOSTUpdate an existing row in the specified employee table using the v1.1 table-row update endpoint.
Employee Verification5
Enable or disable the employee verification integrationsetVerificationIntegrationPUTEnables or disables the company's employee verification integration.
Get employee verification integration statusgetVerificationIntegrationGETReturns the install state and partner metadata for the company's employee verification integration.
List employee verification records for an employeelistEmployeeVerificationsGETReturns every employee verification row for the given employee (including archived), newest first.
Send employee verification lifecycle email by user and email typesendVerificationLifecycleEmailPOSTAccepts a Bamboo userId (path) and an emailType (body) and queues the corresponding employee verification lifecycle email-the same templates as the in-app auth listener (signup survey...
Update an employee verification recordupdateEmployeeVerificationPUTPartial update of a single employee verification row.
Employees7
Create EmployeecreateEmployeePOSTCreate a new employee.
Delete employeedeleteEmployeeDELETEPermanently deletes an employee record and all associated data.
Get Company InformationgetCompanyInformationGETReturns basic profile information for the company, including its legal name, display name, primary address, and contact phone number.
Get EmployeegetEmployeeGETReturns a single employee record as a JSON object (or XML when Accept: application/xml).
Get Employees DirectorygetEmployeeDirectoryGETReturns the company's published employee directory: a fieldset definition plus an array of employee records whose keys match the field ids.
List EmployeeslistEmployeesGETLists all employees in the authenticated caller's company as a cursor-paginated list.
Update EmployeeupdateEmployeePOSTUpdate an employee's fields by submitting a JSON object or XML document containing field name/value pairs.
Goals19
Close GoalcloseGoalPOSTCloses a goal, moving it to the closed status.
Create GoalcreateGoalPOSTCreate a new goal for an employee.
Create Goal CommentcreateGoalCommentPOSTCreates a new comment on a goal.
Delete GoaldeleteGoalDELETEPermanently deletes a goal for an employee.
Delete Goal CommentdeleteGoalCommentDELETEDeletes a goal comment.
Get Alignable Goal OptionslistGoalAlignmentOptionsGETReturns goals that can be used as alignment targets.
Get Goal AggregategetGoalAggregateGETReturns a single goal with its comments, alignment options, and a list of all persons who are either shared on the goal or have commented on it.
Get Goal Creation PermissiongetGoalCreatePermissionGETDetermine if the authenticated caller has permission to create a goal for this employee.
Get Goal Filters (v1.2)getGoalFiltersGETGet the number of goals per status for an employee, including goals with milestones.
Get Goals Aggregate (v1.2)getGoalsAggregateGETProvides a goals dashboard for an employee: goals matching the selected filter, status filter counts/actions, comment counts, and people shared with or commenting on those goals.
List Goal CommentslistGoalCommentsGETReturns comments for a goal, including each comment's ID, author, text, creation time, and edit/delete permissions.
List Goal Sharing OptionslistGoalShareOptionsGETProvides a list of employees with whom the specified employee\'s goals may be shared.
List GoalslistGoalsGETReturns goals for an employee.
Reopen GoalreopenGoalPOSTReopens a closed goal, returning it to the in-progress status.
Update Goal (v1.1)updateGoalPUTUpdate a goal's top-level fields and optionally add or delete milestones.
Update Goal CommentupdateGoalCommentPUTUpdates the text of an existing goal comment.
Update Goal ProgressupdateGoalProgressPUTUpdate the progress percentage of a simple, non-milestone goal.
Update Goal SharingupdateGoalSharingPUTReplaces the full list of employees this goal is shared with.
Update Milestone ProgressupdateMilestoneProgressPUTUpdate the progress of a milestone in a goal.
Holidays8
Bulk Create Company HolidaysbulkInsertCompanyHolidaysPOSTCreates multiple company holidays in one synchronous call.
Create Company HolidaycreateCompanyHolidayPOSTCreates a company holiday.
Delete Company HolidaydeleteCompanyHolidayDELETESoft-deletes a company holiday and removes its audience, pay, and country sub-rows.
Get Catalog HolidaygetCatalogHolidayGETGets a global holiday catalog entry by UUID.
Get Company HolidaygetCompanyHolidayGETGets a company holiday by ID.
List Catalog HolidayslistCatalogHolidaysGETLists entries in the global holiday catalog.
List Company HolidayslistCompanyHolidaysGETReturns a paginated list of active company holidays.
Update Company HolidayupdateCompanyHolidayPATCHUpdates a company holiday with a JSON Merge Patch (RFC 7396) document.
Hours1
Get Time Tracking RecordgetHourRecordGETRetrieves a single time tracking hour record by its ID.
Locations5
Create a job locationcreateJobLocationPOSTCreates a new job location.
Delete a job locationdeleteJobLocationDELETEDeletes a job location by its ID.
Get a job locationgetJobLocationGETRetrieves a single job location by its ID.
List job locationslistJobLocationsGETRetrieves a paginated list of job locations.
Update a job locationupdateJobLocationPUTUpdates an existing job location.
Meal & Rest Breaks20
Assign Employees to Break PolicyassignBreakPolicyEmployeesPOSTAssigns employees to a break policy.
Create BreakcreateBreakPOSTCreates a new break and associates it with the specified break policy.
Create Break PolicycreateBreakPolicyPOSTCreate a break policy.
Delete BreakdeleteBreakDELETEDeletes a time tracking break by its UUID.
Delete Break PolicydeleteBreakPolicyDELETEDeletes a break policy by its UUID.
Get BreakgetBreakGETRetrieves a single time tracking break by its UUID.
Get Break PolicygetBreakPolicyGETRetrieves a single break policy by its UUID.
Get Break Policy SuggestionsgetBreakPolicySuggestionsPOSTUses an AI agent to analyze existing break policies and company context, then returns structured meal and rest break policy recommendations ready for form pre-fill.
List Break AssessmentslistBreakAssessmentsGETReturns a paginated list of break assessments.
List Break PolicieslistBreakPoliciesGETReturns a paginated list of all break policies.
List Break Policy EmployeeslistBreakPolicyEmployeesGETRetrieves employees assigned to a specific break policy.
List Breaks for Break PolicylistBreaksForPolicyGETReturns a paginated list of breaks belonging to the specified break policy.
List Employee Break AvailabilitieslistEmployeeBreakAvailabilitiesGETRetrieves break availability information for an employee.
List Employee Break PolicieslistEmployeeBreakPoliciesGETRetrieves break policies assigned to a specific employee.
Replace Breaks for Break PolicyreplaceBreaksForPolicyPUTReplace all breaks for a break policy.
Set Employees for Break PolicysetBreakPolicyEmployeesPUTSets the employee assignments for a break policy.
Sync Break PolicysyncBreakPolicyPUTPerforms a full replacement of a break policy and its related data (breaks and employee assignments).
Unassign Employees from Break PolicyunassignBreakPolicyEmployeesPOSTUnassigns the specified employees from a break policy.
Update BreakupdateBreakPATCHPartially updates a time tracking break identified by its UUID.
Update Break PolicyupdateBreakPolicyPATCHPartially updates a break policy identified by its UUID.
Onboarding12
Cancel new hire packetcancelNewHirePacketPOSTCancels the new hire packet.
Create employee onboarding experiencecreateOnboardingExperiencePOSTCreates (starts) an onboarding experience workflow for the employee’s existing new hire packet instance.
Create new hire packetcreateNewHirePacketPOSTCreates a new hire packet instance (draft) for an employee.
Delete new hire packetdeleteNewHirePacketDELETEDeletes a new hire packet instance by primary key.
Get employee onboarding experience by idgetOnboardingExperienceGETReturns a single onboarding experience when the onboarding experience phase-1 and workflow framework company toggles are enabled, the employee has at least one running...
Get new hire packet by idgetNewHirePacketGETReturns a single new hire packet instance with a derived status.
Get welcome new hires widgetgetNewHiresWidgetGETReturns the upcoming-new-hires data that powers the BambooHR home "Welcome New Hires" widget.
List employee onboarding experienceslistOnboardingExperiencesGETReturns onboarding experiences for the employee when the onboarding experience phase-1 and workflow framework company toggles are enabled, and at least one OnboardingExperienceWorkflow...
List new hire packetslistNewHirePacketsGETReturns a paginated list of new hire packet instances for the company.
Send new hire packetsendNewHirePacketPOSTSends the new hire packet for that packet's employee (email or onboarding experience workflow, depending on company configuration).
Update GTKY answer visibility for a new hire packetsetGtkyVisibilityPUTShows or hides get-to-know-you (GTKY) question answers for the packet.
Update new hire packetupdateNewHirePacketPUTUpdates an existing new hire packet instance.
Pay Grades & Bands14
Delete Compensation Level Groups or LeveldeleteLevelGroupsDELETEDeletes compensation level configuration, with the behavior chosen by the {segment} path value.
Get Compensation Level Group Status CountsgetLevelGroupStatusCountsGETReturns the number of compensation level groups in each lifecycle status.
Get Job Titles and Level AssignmentsgetJobTitleLevelsGETReturns the working draft configuration showing which job titles are assigned to each compensation level, as used by the pay grades and bands setup wizard.
Get Levels and Bands ReviewgetLevelsAndBandsReviewGETReturns the pre-publish review of compensation level groups and levels with validation errors and warnings consolidated across every setup-wizard step: level naming, group-level checks,...
Get Levels and Bands StatusgetLevelsAndBandsStatusGETReturns the configuration status of the Pay Grades & Bands (levels and bands) setup, broken down by setup step.
Get Pay BandsgetPayBandsGETReturns the working draft pay band configuration for every compensation level, including the pay-band-step validation errors and warnings used by the setup wizard.
Get Published Levels and BandsgetPayGradesAndBandsGETReturns the currently published pay grades and bands as a JSON object with a groups array.
List Compensation Level Groups and LevelslistLevelGroupsGETReturns the working draft configuration of compensation level groups and levels, including the per-group and per-level validation errors and warnings used by the setup wizard.
List Job Titles with EmployeeslistJobTitlesWithEmployeesGETReturns every active, non-archived company job title (not only titles used in the pay grades and bands configuration) together with the employees who currently hold each title.
Publish Draft Compensation Level GroupspublishLevelGroupsPOSTPublishes the company draft compensation configuration, promoting every draft compensation level group, along with its levels, pay bands, and job-title assignments, to the live published...
Replace Job Title Level AssignmentsupdateJobTitleLevelsPUTReplaces the complete set of draft job title-to-compensation-level assignments with the associations in the request.
Update Compensation Level Groups and LevelssaveLevelGroupsPUTCreates or updates compensation level groups and their levels in the company draft configuration.
Update Pay BandsupdatePayBandsPUTUpdates the pay band values (min, mid, max, percentageRange) for compensation levels in the company's draft pay grades and bands.
Upload Levels and Bands CSVimportLevelsAndBandsPOSTParses an uploaded levels and bands CSV and returns a preview of the parsed rows along with a suggested column mapping.
Photos2
Get Employee PhotogetEmployeePhotoGETReturns an employee photo at the requested size.
Upload Employee PhotouploadEmployeePhotoPOSTUploads a new photo for an employee.
Public Api5
Create Hour RecordcreateHourRecordPOSTAdds a single hour record.
Create or Update Hour RecordsstoreHourRecordsPOSTBulk add/edit hour records.
Delete Hour RecorddeleteHourRecordDELETEDeletes an hour record by timeTrackingId (id path parameter).
Update Company Industry CodesupdateIndustryCodesPUTUpdates the industry codes associated with a company.
Update Hour RecordadjustHourRecordPUTEdits an existing hour record by timeTrackingId.
Scheduling14
Create SchedulecreateSchedulePOSTCreates a new schedule for the company.
Create ShiftcreateShiftPOSTCreates a new shift in the specified schedule.
Delete ScheduledeleteScheduleDELETEDeletes a schedule by its UUID.
Delete ShiftdeleteShiftDELETEDeletes a shift by its UUID or composite recurrence ID.
Get SchedulegetScheduleGETRetrieves a specific schedule by its UUID.
Get Schedule PDFgetSchedulePdfGETGenerates and streams a PDF of the schedule view for the given schedule and date range.
Get ShiftgetShiftGETRetrieves a single shift by its UUID.
List ScheduleslistSchedulesGETRetrieves a paginated list of all schedules for the company.
List Shift AssessmentslistShiftAssessmentsGETLists shift assessments matching the given filters.
List ShiftslistShiftsGETLists shifts matching the given filters.
List TimezoneslistSchedulingTimezonesGETReturns a paginated list of timezones available for use when creating or editing schedules.
Publish ShiftspublishShiftsPOSTPublishes one or more planned shifts, making them visible to employees.
Update ScheduleupdateSchedulePATCHPartially updates an existing schedule by its UUID.
Update ShiftupdateShiftPATCHUpdates a shift by its UUID.
Time Off11
Adjust Time Off BalanceadjustTimeOffBalancePUTCreates a balance adjustment for an employee's time off type.
Assign Time Off Policies (v1.1)assignTimeOffPoliciesPUTAssigns time off policies to an employee with accruals starting on the specified date.
Create Time Off History ItemcreateTimeOffHistoryItemPUTCreates a time off history item for an employee.
Create Time Off RequestcreateTimeOffRequestPUTCreates a time off request for an employee.
Get Time Off BalancegetTimeOffBalanceGETReturns time off balances for an employee across all assigned categories as of a given date.
List Employee Time Off Policies (v1.1)listEmployeeTimeOffPoliciesGETReturns the time off policies currently assigned to a specific employee, as a list of {timeOffPolicyId, timeOffTypeId, accrualStartDate} records.
List Time Off PolicieslistTimeOffPoliciesGETReturns all non-deleted time off policies for the company, sorted alphabetically by name.
List Time Off RequestslistTimeOffRequestsGETReturns time off requests within the specified date range.
List Time Off TypeslistTimeOffTypesGETLists the company's active time off types - PTO options, vacation, sick leave, and other time off categories - along with the company's default hours-per-day schedule.
List Who’s OutlistWhosOutGETReturns a date-sorted list of employees who are out and company holidays for the specified period.
Update Time Off Request StatusupdateTimeOffRequestStatusPUTUpdates the status of an existing time off request.
Time Tracking38
Approve TimesheetapproveTimesheetPOSTApproves a timesheet (process resource).
Clock IncreateClockInPOSTClocks an employee in at the current server time, creating an open clock entry (end: null).
Clock OutcreateClockOutPOSTClocks an employee out at the current server time, closing the employee's open clock entry (end set, endSource: USER).
Create Clock EntrycreateClockEntryPOSTManually creates a time tracking clock entry (corrections, retroactive entry).
Create Hour EntrycreateHourEntryPOSTCreates a new time tracking hour entry.
Create or Update Timesheet Clock EntriesstoreClockEntriesPOSTCreates or updates timesheet clock entries in bulk.
Create or Update Timesheet Hour EntriesstoreHourEntriesPOSTCreates or updates timesheet hour entries in bulk.
Create Time Tracking ProjectcreateTimeTrackingProjectPOSTCreates a time tracking project.
Create Time Tracking Project TaskcreateProjectTaskPOSTCreates a new task on the specified time tracking project.
Create Time Tracking Shift DifferentialcreateShiftDifferentialPOSTCreates a new time tracking shift differential.
Create Timesheet Clock-In EntryclockInPOSTClocks in an employee at the current server time.
Create Timesheet Clock-Out EntryclockOutPOSTClocks out a currently clocked-in employee at the current server time.
Delete Clock EntrydeleteClockEntryDELETEDeletes a time tracking clock entry by its ID.
Delete Hour EntrydeleteHourEntryDELETEDeletes a time tracking hour entry by its ID.
Delete Time Tracking ProjectdeleteTimeTrackingProjectDELETEDeletes a time tracking project by its ID.
Delete Time Tracking Shift DifferentialdeleteShiftDifferentialDELETEDeletes a time tracking shift differential by its ID.
Delete Time Tracking TaskdeleteTimeTrackingTaskDELETEDeletes a time tracking task by its ID.
Delete Timesheet Clock EntriesdeleteClockEntriesPOSTDeletes one or more timesheet clock entries by their IDs.
Delete Timesheet Hour EntriesdeleteHourEntriesPOSTDeletes one or more timesheet hour entries by their IDs.
Get Clock EntrygetClockEntryGETRetrieves a single clock entry by its ID.
Get Hour EntrygetHourEntryGETRetrieves a single hour entry by its ID.
Get Time Tracking ProjectgetTimeTrackingProjectGETRetrieves a single time tracking project by its ID, including the list of employees assigned to it.
Get Time Tracking Shift DifferentialgetShiftDifferentialGETRetrieves a single time tracking shift differential by its ID.
Get Time Tracking TaskgetTimeTrackingTaskGETRetrieves a single time tracking task by its ID.
Get TimesheetgetTimesheetGETRetrieves a single timesheet by its ID.
Get Timesheet SummarygetTimesheetSummaryGETReturns the daily breakdown of hours for a timesheet, including regular, overtime, and double-time hours per day.
List Clock EntrieslistClockEntriesGETReturns a paginated list of time tracking clock entries.
List Hour EntrieslistHourEntriesGETReturns a paginated list of time tracking hour entries.
List Time Tracking Project TaskslistProjectTasksGETReturns a paginated list of tasks for the specified time tracking project.
List Time Tracking ProjectslistTimeTrackingProjectsGETReturns a paginated list of time tracking projects.
List Time Tracking Shift DifferentialslistShiftDifferentialsGETReturns a paginated list of time tracking shift differentials.
List Timesheet EntrieslistTimesheetEntriesGETReturns timesheet entries for all employees, or a filtered subset, within the specified date range.
List TimesheetslistTimesheetsGETReturns a paginated list of timesheets.
Update Clock EntryupdateClockEntryPATCHPartially updates a time tracking clock entry identified by its ID.
Update Hour EntryupdateHourEntryPATCHPartially updates a time tracking hour entry identified by its ID.
Update Time Tracking ProjectupdateTimeTrackingProjectPATCHPartially updates a time tracking project identified by its ID.
Update Time Tracking Shift DifferentialupdateShiftDifferentialPATCHPartially updates a time tracking shift differential identified by its ID.
Update Time Tracking TaskupdateTimeTrackingTaskPATCHPartially updates a time tracking task identified by its ID.
Total Rewards8
Add Employees to Total RewardsaddTotalRewardsEmployeesPOSTAdd employees to Total Rewards.
Check Total Rewards Profile AvailabilitycheckTotalRewardsProfileGETCheck if the given employee has an active Total Rewards profile and the current user has permission to view it.
Get Printable Total Rewards StatementgetPrintableTotalRewardsGETGenerate and return a PDF printable version of the employee's Total Rewards statement.
Get Total Rewards StatementgetTotalRewardsStatementGETReturns the full Total Rewards statement for the given employee, including compensation, benefits, bonuses, equity, reimbursements, and time-off data.
Remove Employees from Total RewardsremoveTotalRewardsEmployeesDELETERemove employees from Total Rewards.
Remove Total Rewards Custom DisclaimerremoveTotalRewardsDisclaimerDELETERemove the company-wide Total Rewards custom disclaimer.
Set Total Rewards Custom DisclaimersetTotalRewardsDisclaimerPUTSet the company-wide Total Rewards custom disclaimer text shown on employee statements.
Set Total Rewards Onboarding Step StatussetTotalRewardsOnboardingStepPUTSet a Total Rewards onboarding step to completed or incomplete.
Training12
Create Employee Training RecordcreateTrainingRecordPOSTCreates a new training record for the specified employee.
Create Training CategorycreateTrainingCategoryPOSTCreates a new training category.
Create Training TypecreateTrainingTypePOSTCreates a new training type.
Delete Employee Training RecorddeleteTrainingRecordDELETEDelete an existing employee training record.
Delete Training CategorydeleteTrainingCategoryDELETEDelete an existing training category.
Delete Training TypedeleteTrainingTypeDELETEDelete an existing training type.
List Employee Training RecordslistTrainingRecordsGETReturns all training records for the specified employee as an object keyed by training record ID.
List Training CategorieslistTrainingCategoriesGETReturns all training categories for the company as an object keyed by category ID.
List Training TypeslistTrainingTypesGETReturns all training types for the company as an object keyed by training type ID.
Update Employee Training RecordupdateTrainingRecordPUTUpdates an existing employee training record.
Update Training CategoryupdateTrainingCategoryPUTUpdates the name of an existing training category.
Update Training TypeupdateTrainingTypePUTUpdates an existing training type.
Webhooks8
Create WebhookcreateWebhookPOSTCreates a new webhook for the authenticated user.
Delete WebhookdeleteWebhookDELETEPermanently removes a webhook owned by the authenticated user.
Get WebhookgetWebhookGETReturns the full configuration of a single webhook owned by the authenticated user, including its name, URL, format, monitored fields and post fields when applicable, events, creation...
Get Webhook Post FieldslistPostFieldsGETReturns an object containing the employee fields that can be included in the webhook post body for field-based webhooks.
List Monitor FieldslistMonitorFieldsGETReturns the list of employee fields that can be monitored by a webhook.
List Webhook LogslistWebhookLogsGETReturns an array of recent delivery log entries for a webhook.
List WebhookslistWebhooksGETReturns all webhooks owned by the authenticated user.
Update WebhookupdateWebhookPUTPerforms a full replacement update of a webhook - all request body fields overwrite existing values, so omitted optional fields revert to defaults.