HR WORKS MCP connector

• Get Get single HR WORKS absence job by ID Get the status and result of an asynchronous absence write. id is the jobId returned by absences.create, absences.bulk_update, absences.bulk_delete, absences.update, absences.delete. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Get HR WORKS absence jobs get or error Get the status of an absences write job, like get (GET /v2/absences/jobs/{jobId}), except that an HTTP error from HR WORKS (e.g. 429 rate limit, 5xx) is returned as a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified timeoff_requests create/update/delete mappings, which poll the job after HR WORKS accepted the write and must still report the job id when a poll fails.
• Get Get single HR WORKS absence type job by ID Get the status and result of an asynchronous absence type write. id is the jobId returned by absence_types.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS absence types List the absence types configured in HR WORKS with their key, name and rules (holiday entitlement, time account, substitution, payroll use). Use the keys as the types filter of absences.list; onlyActive=true returns only active types. Not paginated: everything comes back in one response.
• Create Create a HR WORKS absence type Create absence types in bulk: body {data: [...]} with 1-1000 types (name, key and rule flags such as reducesHolidayEntitlement or isSubstitutionMandatory). Asynchronous: returns a jobId; poll absence_type_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS absences List absences per person in a date range (type, dates, half-days, status, working days); filter by persons, types or statusFilter. interval splits the range (days, weeks, months); count=true returns per-type day totals instead. Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS absence by ID Get one absence; id is the absence number (the person's license number, an underscore, then the person's running absence number), as returned by absences.list.
• Create Create a HR WORKS absence Create absences in bulk: body {data: [...]} with 1-100 absences. Each item needs type, beginDate, endDate, status, personnelNumber. Asynchronous: returns a jobId; poll absence_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update Update a HR WORKS absence by ID Edit one absence; id is its absence number. Send only what changes (type, dates, half-day flags, status, substitutes, remark); attributes you leave out stay unchanged. Asynchronous: returns a jobId; poll absence_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete Delete a HR WORKS absence by ID Delete one absence; id is its absence number (the person's license number, an underscore, then the running absence number). Asynchronous: returns a jobId; poll absence_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS absences bulk update Edit absences in bulk: body {data: [...]} with 1-100 items, each identified by its absence number; attributes you leave out stay unchanged (mandatory ones excepted). Each item needs number. Asynchronous: returns a jobId; poll absence_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete HR WORKS absences bulk delete Delete several absences at once: numbers lists 1-100 absence numbers (license number, underscore, running number). Required: numbers. Asynchronous: returns a jobId; poll absence_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List HR WORKS absences list or error List absences like list (GET /v2/absences, one page, the same required beginDate/endDate parameters), but return HR WORKS's whole response (the map of person identifier to date intervals) and, when HR WORKS answers an HTTP error (e.g. 429 rate limit, 5xx), a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified timeoff_requests create mapping to read the new absence back after its write job finished, so a failing read-back can still report the job id.
• List List all HR WORKS accumulated absences Get per-person totals of absence working days by absence type for a date range; filter by persons, types or statusFilter, and split the range with interval (days, weeks or months). Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• List List all HR WORKS accumulated remote work Get per-person totals of remote-work working days for a date range; filter by persons or statusFilter, and split the range with interval (days, weeks or months). Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• List List all HR WORKS accumulated sick leaves Get per-person totals of sick-leave working days by sick leave type for a date range; filter by persons, types or statusFilter, and split the range with interval (days, weeks or months). Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• List List all HR WORKS applicants List applicants (only applicants that have job applications): name, contact data, address, birthday and more. Filter by applicant uuids (applicants) or by the status of their job applications (statusFilter). Paginated by HR WORKS at 50 per page (limit is ignored); pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS applicant by ID Get one applicant; id is the applicant's uuid, which stays the same when the applicant later becomes an employee. Returns: address, birthday, earliestPossibleJoinDate, email, firstName, gender, uuid, hasNoticePeriod and more.
• List List all HR WORKS available working hours Get each person's available working hours (working hours, regular working hours, remarks, related events) for a date range, optionally split by interval into days, weeks or months; choose persons with personIdentifierType. Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 150 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS cost center assignment job by ID Get the status and result of an asynchronous cost center assignment write. id is the jobId returned by cost_center_assignments.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Create Create a HR WORKS cost center assignment Assign cost centers to persons and/or organization units in bulk: body {data: [...]} with 1-2000 assignments; personIdentifierType sets the type of each personIdentifier (uuid by default). Asynchronous: returns a jobId; poll cost_center_assignment_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS cost center job by ID Get the status and result of an asynchronous cost center write. id is the jobId returned by cost_centers.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Get HR WORKS cost center jobs get or error Get the status of a cost centers write job, like get (GET /v2/cost-objects/cost-centers/jobs/{jobId}), except that an HTTP error from HR WORKS (e.g. 429 rate limit, 5xx) is returned as a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified groups create/update mappings, which poll the job after HR WORKS accepted the write and must still report the job id when a poll fails.
• List List all HR WORKS cost centers List all cost centers of the company (number and name). Paginated by HR WORKS at 10000 per page (limit is ignored); pass next_cursor with the same filters for the next page.
• Create Create a HR WORKS cost center Create cost centers in bulk: body {data: [...]} with 1-1000 items (number, name); overwriteNames=true renames an existing cost center that has the same number. Asynchronous: returns a jobId; poll cost_center_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List HR WORKS cost centers list or error List cost centers like list (GET /v2/cost-objects/cost-centers, first page only, up to 10000), but return HR WORKS's whole response ({"costCenters": [...]}) and, when HR WORKS answers an HTTP error (e.g. 429 rate limit, 5xx), a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified groups create/update mappings to read the cost center back after its write job finished, so a failing read-back can still report the job id.
• Get Get single HR WORKS cost objective assignment job by ID Get the status and result of an asynchronous cost objective assignment write. id is the jobId returned by cost_objective_assignments.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Create Create a HR WORKS cost objective assignment Assign cost objectives to persons and/or organization units in bulk: body {data: [...]} with 1-2000 assignments; personIdentifierType sets the type of each personIdentifier (uuid by default). Asynchronous: returns a jobId; poll cost_objective_assignment_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS cost objective job by ID Get the status and result of an asynchronous cost objective write. id is the jobId returned by cost_objectives.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS cost objectives List all cost objectives of the company (number and name). Paginated by HR WORKS at 10000 per page (limit is ignored); pass next_cursor with the same filters for the next page.
• Create Create a HR WORKS cost objective Create cost objectives in bulk: body {data: [...]} with 1-1000 items (number, name); overwriteNames=true renames an existing cost objective that has the same number. Asynchronous: returns a jobId; poll cost_objective_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Create Create a HR WORKS document pool file Upload a file to the HR WORKS document pool. Required: fileName. Give the file as url (HR WORKS downloads it) or send its bytes (up to 15 MB): call the Truto proxy with truto_body_passthrough=true and the file's MIME type as Content-Type (MCP tools can only pass url). Asynchronous: returns a jobId; poll person_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS expense report job by ID Get the status and result of an asynchronous travel expense report write. id is the jobId returned by expense_reports.create, expense_reports.update. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS expense reports List travel expense reports per person in a date range; choose persons with personIdentifierType, filter with statusFilter, and add receipt collections without a trip with includeExpenseReportsWithoutTrip=true. Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 20 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS expense report by ID Get one travel expense report with its days, receipts, advances and totals; id is its number (the person's personnel number, a dash, then the trip number).
• Create Create a HR WORKS expense report Create travel expense reports in bulk: body {data: [...]} (HR WORKS documents no maximum); personIdentifierType sets the type of the personIdentifier values (personnel number by default). Each item needs personIdentifier, beginDate, endDate. Asynchronous: returns a jobId; poll expense_report_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update Update a HR WORKS expense report by ID Change the status of one travel expense report (statusIdentifier is the only editable property); id is its number (the person's license number, a hyphen, then the running expense report number). Asynchronous: returns a jobId; poll expense_report_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS health check Check that the HR WORKS API is up and accepts this connection's access token; Truto uses it to validate new connections. HR WORKS documents no response body: a successful call means the API is reachable.
• Get Get single HR WORKS holiday job by ID Get the status and result of an asynchronous holiday write. id is the jobId returned by holidays.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS holidays List the holidays of one year for the company, its countries and permanent establishments; filter with countryCodes (ISO 3166-1 alpha-3) or permanentEstablishments (general holidays of the country stay included). Required: year. Not paginated: the result is ONE object keyed by ISO 3166-1 alpha-3 country code; `<key>` in the response schema is a placeholder, not a field.
• Create Create a HR WORKS holiday Create company holidays in bulk: body {data: [...]} with 1-1000 holidays (date, name, half-day flag). Scope each one with countryCode, state (together with countryCode) or permanentEstablishmentId; at least one of them is required. Asynchronous: returns a jobId; poll holiday_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Create Create a HR WORKS job application file Attach a file to a job application; job_application_id is the application's id. Required: fileName, job_application_id. Give the file as url (HR WORKS downloads it) or send its bytes (up to 15 MB): call the Truto proxy with truto_body_passthrough=true and the file's MIME type as Content-Type (MCP tools can only pass url). Asynchronous: returns a jobId; poll job_application_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS job application job by ID Get the status and result of an asynchronous job application write. id is the jobId returned by job_applications.create, job_applications.update, job_applications.delete, job_application_files.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS job applications List job applications with their applicant, documents, post and status; filter by post ids (posts) and status identifiers (statusFilter). Paginated by HR WORKS at 50 per page (limit is ignored); pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS job application by ID Get one job application (HR WORKS API v3); id is the job application's uuid. Truto returns the data object of the v3 response. Returns: id, statusIdentifier, postUuid, applicant, applicationDocuments, creationDateAndTime, desiredSalary, expectedSalary and more.
• Create Create a HR WORKS job application Create job applications in bulk: body {data: [...]} with 1-100 applications, each holding applicant and application details. Each item needs firstName, lastName, postId. Asynchronous: returns a jobId; poll job_application_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update Update a HR WORKS job application by ID Edit one job application; id is its uuid. Only the attributes you send change (post, post offer, desired salary, remark, privacy flags, statusIdentifier). Asynchronous: returns a jobId; poll job_application_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete Delete a HR WORKS job application by ID Delete one job application; id is its uuid, as returned by job_applications.list. Asynchronous: returns a jobId; poll job_application_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS leave accounts Get leave-account figures per person (entitlement, requested, approved, planned, expiring and more) for the period from January 1 of referenceDate's year up to referenceDate; filter by persons or add leavers with onlyActive=false. Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS leave account by ID Get one person's leave account (entitlement, requested, approved, planned, expiring and more); id is the person's HR WORKS personnel number. referenceDate sets the end of the period, which starts on January 1 of that year.
• Create Create a HR WORKS onboarding document file Attach a file to an onboarding document; onboarding_document_id is the document id. Required: fileName, onboarding_document_id. Give the file as url (HR WORKS downloads it) or send its bytes (up to 15 MB): call the Truto proxy with truto_body_passthrough=true and the file's MIME type as Content-Type (MCP tools can only pass url). Asynchronous: returns a jobId; poll onboarding_document_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS onboarding document job by ID Get the status and result of an asynchronous onboarding document write. id is the jobId returned by onboarding_documents.create, onboarding_documents.update, onboarding_document_files.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS onboarding documents List the onboarding documents of the company (the data collected from new hires before they become persons); filter by statusFilter or organizationUnits. Not paginated: everything comes back in one response.
• Get Get single HR WORKS onboarding document by ID Get one onboarding document with the new hire's personal, address, bank and tax data; id is its id, as returned by onboarding_documents.list. Returns: address, bankAccount, birthday, birthName, confession, countryOfBirth, childAllowanceCategory, emergencyContactDegreeOfKinship and more.
• Create Create a HR WORKS onboarding document Create onboarding documents for new hires in bulk: body {data: [...]} with 1-100 documents. Each item needs privateEmail, firstName, lastName, organizationUnitNumber, joinDate. Asynchronous: returns a jobId; poll onboarding_document_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update Update a HR WORKS onboarding document by ID Edit one onboarding document; id is its id. HR WORKS ignores attributes you leave out, but its schema marks firstName, lastName, privateEmail, organizationUnitNumber and joinDate as required. Asynchronous: returns a jobId; poll onboarding_document_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS organization unit job by ID Get the status and result of an asynchronous organization unit write. id is the jobId returned by organization_units.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Get HR WORKS organization unit jobs get or error Get the status of an organization units write job, like get (GET /v2/organization-units/jobs/{jobId}), except that an HTTP error from HR WORKS (e.g. 429 rate limit, 5xx) is returned as a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified groups create mapping, which polls the job after HR WORKS accepted the write and must still report the job id when a poll fails.
• List List all HR WORKS organization unit present persons List the persons of one organization unit who are in the office right now: HR WORKS leaves out vacations, trips, sick leaves and other absences, counted by forenoon and afternoon. Required: organization_unit_number. Not paginated: everything comes back in one response.
• List List all HR WORKS organization units List all active organization units of the company (number, name, parent unit, SAP codes, country and more). Not paginated: everything comes back in one response.
• Get Get single HR WORKS organization unit by ID Get one organization unit; id is its uuid (passing the unit number instead is deprecated by HR WORKS). Returns: parentOrganizationUnit, number, name, additionalName, sapCodeType, sapUnitCode, countryCode, uuid.
• Create Create a HR WORKS organization unit Create organization units in bulk: body {data: [...]} with 1-500 units; parent and child units can be created in the same call. Each item needs number, name, parentOrganizationUnitNumber, countryCode. Asynchronous: returns a jobId; poll organization_unit_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List HR WORKS organization units list or error List the active organization units like list (GET /v2/organization-units, one call, no paging), but return HR WORKS's whole response ({"organizationUnits": [...]}) and, when HR WORKS answers an HTTP error (e.g. 429 rate limit, 5xx), a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified groups create mapping to read the new unit back after its write job finished, so a failing read-back can still report the job id.
• Get Get single HR WORKS payroll file job by ID Get the status and result of an asynchronous payroll file write. id is the jobId returned by payroll_files.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Create Create a HR WORKS payroll file Upload a payroll file for a person and a year (optionally a month). Choose the person with personIdentifier and personIdentifierType (uuid by default; personnelNumber is deprecated). Required: fileName, year. Give the file as url (HR WORKS downloads it) or send its bytes (up to 15 MB): call the Truto proxy with truto_body_passthrough=true and the file's MIME type as Content-Type (MCP tools can only pass url). Asynchronous: returns a jobId; poll payroll_file_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS permanent establishment job by ID Get the status and result of an asynchronous permanent establishment write. id is the jobId returned by permanent_establishments.create, permanent_establishments.bulk_update. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS permanent establishments List all active permanent establishments (business locations) of the company: id, number, name and address. Not paginated: everything comes back in one response.
• Get Get single HR WORKS permanent establishment by ID Get one permanent establishment (business location): id, number, name and address; id is its id, as returned by permanent_establishments.list. Returns: id, name, address, number.
• Create Create a HR WORKS permanent establishment Create permanent establishments (business locations) in bulk: body {data: [...]} with 1-1000 items (id, number, name, address). Asynchronous: returns a jobId; poll permanent_establishment_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS permanent establishments bulk update Edit permanent establishments in bulk: body {data: [...]} with 1-1000 items (id, number, name, address). Asynchronous: returns a jobId; poll permanent_establishment_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Create Create a HR WORKS person document Upload a file to one person's document pool; person_identifier selects the person (personIdentifierType sets its type, personId by default). Required: fileName, person_identifier. Give the file as url (HR WORKS downloads it) or send its bytes (up to 15 MB): call the Truto proxy with truto_body_passthrough=true and the file's MIME type as Content-Type (MCP tools can only pass url). Asynchronous: returns a jobId; poll person_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS person job by ID Get the status and result of an asynchronous person write. id is the jobId returned by persons.create, persons.bulk_update, document_pool_files.create, person_documents.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Get HR WORKS person jobs get or error Get the status of a persons write job, like get (GET /v2/persons/jobs/{jobId}), except that an HTTP error from HR WORKS (e.g. 429 rate limit, 5xx) is returned as a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified employees create/update mappings, which poll the job after HR WORKS accepted the write and must still report the job id when a poll fails.
• List List all HR WORKS person master data Get full master data (contact, address, bank account, employment, organization and more) for many persons; choose persons with persons and personIdentifierType, or add leavers with onlyActive=false. Paginated by HR WORKS at 50 per page (limit is ignored); pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS person master datum by ID Get one person's full master data; id is the person identifier, a personnel number unless personIdentifierType says otherwise. Custom master-data fields defined in HR WORKS are returned as extra properties.
• List List all HR WORKS person wage payments List one person's wage payments (HR WORKS API v3): month, gross amount, wage type and more; person_uuid is the person's uuid. Required: person_uuid. Paginated (page size not documented; limit is ignored); pass next_cursor with the same filters for the next page. HR WORKS documents page links only for v2, so paging may stop after page 1.
• Get Get single HR WORKS person working time status by ID Get whether a person is clocked in right now and, if so, the current working time; id is the person identifier (a personnel number by default). Returns: clockedIn, workingTime.
• Create Create a HR WORKS person working time Clock a person in or out now; person_identifier is a personnel number by default. action is clockIn or clockOut, and a clockIn needs type. beginDateAndTime or endDateAndTime (ISO 8601 UTC) may backdate it by up to 24 hours. Required: action, person_identifier. Synchronous: returns the working time and any warnings directly.
• List List all HR WORKS personnel file categories List the personnel file categories of the company (key and name). Use a key as the category filter of personnel_file_entries.list or as the category of a new entry. Not paginated: everything comes back in one response.
• List List all HR WORKS personnel file entries List one person's personnel file entries (category, creation date, documents, name, notes and more); person_identifier selects the person (a personnel number unless personIdentifierType says otherwise). Required: person_identifier. Not paginated: everything comes back in one response.
• Get Get single HR WORKS personnel file entry by ID Get one personnel file entry; id is the entry id and person_identifier the person (a personnel number unless personIdentifierType says otherwise). Required: person_identifier.
• Create Create a HR WORKS personnel file entry Create personnel file entries for many persons: body {data: [...]} with 1-1000 entries; personIdentifierType sets the type of the personIdentifier values in the items. Each item needs name, creationDate, category, personnelNumber. Asynchronous: returns a jobId; poll personnel_file_entry_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Create Create a HR WORKS personnel file entry file Attach a file to one of a person's personnel file entries (personIdentifierType sets the type of person_identifier, personnel number by default). Required: fileName, person_identifier, personnel_file_entry_id. Give the file as url (HR WORKS downloads it) or send its bytes (up to 15 MB): call the Truto proxy with truto_body_passthrough=true and the file's MIME type as Content-Type (MCP tools can only pass url). Asynchronous: returns a jobId; poll personnel_file_entry_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS personnel file entry job by ID Get the status and result of an asynchronous personnel file entry write. id is the jobId returned by personnel_file_entries.create, personnel_file_entry_files.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS persons List persons (base data: names and identifiers such as personId, personnelNumber and uuid) grouped by organization unit; filter with organizationUnits. Only active persons unless onlyActive=false. Not paginated: the result is ONE object keyed by organization-unit number, or uuid when identifierType=uuid; `<key>` in the response schema is a placeholder, not a field.
• Get Get single HR WORKS person by ID Get one person's base data (names and identifiers); id is the person identifier, a personnel number unless personIdentifierType says otherwise (uuid, personId, personLicenseNumber, personIdentifierForKiosk).
• Create Create a HR WORKS person Create employees in bulk: body {data: [...]} with 1-100 persons. HR WORKS notes that creating employees causes license costs. Each item needs personId, personnelNumber. Asynchronous: returns a jobId; poll person_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS persons bulk update Edit employees in bulk: body {data: [...]} with 1-100 persons; attributes you leave out stay unchanged (mandatory ones excepted). Each item needs personId, personnelNumber. Asynchronous: returns a jobId; poll person_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List HR WORKS persons list or error List the company's persons, like list (GET /v2/persons), except that an HTTP error from HR WORKS (e.g. a 403 because the key pair has no permission for /persons, a 429 rate limit or a 5xx) is returned as a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified timeoff_requests, timeoff_balances and timesheet_entries mappings, which resolve the person of every record through this endpoint and must still return the records when it is not readable.
• Get HR WORKS persons get or error Get a single person, like get (GET /v2/persons/{personIdentifier}), except that an HTTP error from HR WORKS (e.g. a 403 because the key pair has no permission for /persons, a 429 rate limit or a 5xx) is returned as a 200 result {"truto_error": {"status": <HTTP status>}} instead of failing. Used by the unified timeoff_requests.get mapping, which resolves the absence's employee from the licence number in the absence number and must still return the absence when that look-up is not permitted.
• List List all HR WORKS persons today Get today's day data per person: target working time and holidays always, plus the sources listed in includeData (such as working times, absences, sick leaves and travel requests). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• List List all HR WORKS posts List the job posts of the company (display name, name, key, uuid, organization unit and more); onlyActive=false also returns inactive posts. Not paginated: everything comes back in one response.
• Get Get single HR WORKS post by ID Get one job post; id is the post's uuid (passing the older post id is deprecated by HR WORKS). Returns: displayName, name, key, uuid, organizationUnitNumber, organizationUnitUuid, contactInformation, scopeOfActivities and more.
• Get Get single HR WORKS project customer job by ID Get the status and result of an asynchronous project customer write. id is the jobId returned by project_customers.create, project_customers.bulk_update. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS project customers List the time-tracking project customers (id, number, name, active flag, project counts); onlyActive=false also returns inactive customers. Not paginated: everything comes back in one response.
• Get Get single HR WORKS project customer by ID Get one time-tracking project customer (id, number, name, active flag, project counts); id is the customer number (the number field of project_customers.list, not its id field).
• Create Create a HR WORKS project customer Create project customers in bulk: body {data: [...]} with 1-1000 customers (name, number). Asynchronous: returns a jobId; poll project_customer_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS project customers bulk update Edit project customers in bulk: body {data: [...]} with 1-1000 items (id, number, name, isActive). Asynchronous: returns a jobId; poll project_customer_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS receipt types List the travel-expense receipt types per country (name, category, key, deduction, flags and accounts); filter with countryCodes (ISO 3166-1 alpha-3), categories or onlyActive=false. Not paginated: Truto returns the receiptTypes object, keyed by 3-letter country code (`<key>` in the response schema is a placeholder) with the receipt types of each country.
• List List all HR WORKS remote work List remote-work entries per person in a date range (dates, half-days, number, status, working days); filter by persons or statusFilter, and split the range with interval (days, weeks or months). Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS remote work by ID Get one remote-work entry; id is its number (the person's license number, an underscore, then the running remote-work number), as returned by remote_work.list.
• Create Create a HR WORKS remote work Create remote-work entries in bulk: body {data: [...]} with 1-100 entries. Each item needs beginDate, endDate, personnelNumber, statusIdentifier. Asynchronous: returns a jobId; poll remote_work_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update Update a HR WORKS remote work by ID Edit one remote-work entry; id is its number. Send only what changes (beginDate, endDate, half-day flags, statusIdentifier). Asynchronous: returns a jobId; poll remote_work_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete Delete a HR WORKS remote work by ID Delete one remote-work entry; id is its number (the person's license number, an underscore, then the running remote-work number). Asynchronous: returns a jobId; poll remote_work_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS remote work bulk update Edit remote-work entries in bulk: body {data: [...]} with 1-100 items, each identified by its remote-work number; attributes you leave out stay unchanged (mandatory ones excepted). Each item needs number. Asynchronous: returns a jobId; poll remote_work_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS remote work job by ID Get the status and result of an asynchronous remote work write. id is the jobId returned by remote_work.create, remote_work.bulk_update, remote_work.update, remote_work.delete. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Get Get single HR WORKS sick leave job by ID Get the status and result of an asynchronous sick leave write. id is the jobId returned by sick_leaves.create, sick_leaves.bulk_update, sick_leaves.bulk_delete, sick_leaves.delete. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Get Get single HR WORKS sick leave type job by ID Get the status and result of an asynchronous sick leave type write. id is the jobId returned by sick_leave_types.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS sick leave types List the sick leave types configured in HR WORKS (key, name, color and visibility flags). Use the keys as the types filter of sick_leaves.list; onlyActive=false also returns deactivated types. Not paginated: everything comes back in one response.
• Create Create a HR WORKS sick leave type Create sick leave types in bulk: body {data: [...]} with 1-1000 types (name, key and flags such as isSicknessOfChild or useInMonthPayroll). Asynchronous: returns a jobId; poll sick_leave_type_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS sick leaves List sick leaves per person in a date range (type, dates, half-days, status, working days); filter by persons, types or statusFilter. interval splits the range (days, weeks, months); count=true returns per-type day totals instead. Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS sick leaf by ID Get one sick leave; id is its number (the person's license number, an underscore, then the running sick leave number), as returned by sick_leaves.list.
• Create Create a HR WORKS sick leaf Create sick leaves in bulk: body {data: [...]} with 1-100 sick leaves. Each item needs type, beginDate, endDate, status, personnelNumber. Asynchronous: returns a jobId; poll sick_leave_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete Delete a HR WORKS sick leaf by ID Delete one sick leave; id is its number (the person's license number, an underscore, then the running sick leave number). Asynchronous: returns a jobId; poll sick_leave_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS sick leaves bulk update Edit sick leaves in bulk: body {data: [...]} with 1-100 items, each identified by its sick leave number; attributes you leave out stay unchanged (mandatory ones excepted). Each item needs number. Asynchronous: returns a jobId; poll sick_leave_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete HR WORKS sick leaves bulk delete Delete several sick leaves at once: numbers lists 1-100 sick leave numbers (license number, underscore, running number). Required: numbers. Asynchronous: returns a jobId; poll sick_leave_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS time accounts Get monthly time accounts per person (working hours, target hours, time credit, carry-over and totals) for the months in monthYears (YYYY-MM, the current month by default); filter by persons. Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• List List all HR WORKS time recording regulations List the time recording regulations of the company (title, key, online and kiosk use, working time types, kiosks and more); their working time types are the types filter of working_times.list. Not paginated: everything comes back in one response.
• Get Get single HR WORKS time tracking project assignment job by ID Get the status and result of an asynchronous project team assignment write. id is the jobId returned by time_tracking_project_assignments.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• Create Create a HR WORKS time tracking project assignment Add persons to project teams in bulk: body {data: [...]} with 1-500 assignments. Each item needs personIdentifier, projectNumber. Asynchronous: returns a jobId; poll time_tracking_project_assignment_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS time tracking project job by ID Get the status and result of an asynchronous time-tracking project write. id is the jobId returned by time_tracking_projects.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS time tracking projects List time-tracking projects, optionally within a beginDate/endDate range; filter by numbers, projectIds, statusFilter, projectType, projectManagerPersonnelNumber or projectCustomerId. Paginated by HR WORKS at 50 per page (limit is ignored); pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS time tracking project by ID Get one time-tracking project (number, name, dates, status, budget, manager, customer and more); id is the project's id field (not its number). Returns: id, number, name, beginDate, endDate, description, parentProject, statusIdentifier and more.
• Create Create a HR WORKS time tracking project Create time-tracking projects in bulk: body {data: [...]} with 1-500 projects. Each item needs id, name, beginDate, status, projectManagerPersonnelNumber, customerId. Asynchronous: returns a jobId; poll time_tracking_project_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• List List all HR WORKS travel requests List travel requests per person in a date range; choose persons with personIdentifierType and filter with statusFilter. Required: beginDate and endDate (at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS travel request by ID Get one travel request (destination, dates, cost center and objective, person and more); id is its number (the person's personnel number, a dash, then the trip request number).
• List List all HR WORKS vacation types List the vacation types of the company per country (key, name, country, active, assigned and default flags). Filter with countryCodes (ISO 3166-1 alpha-3); onlyAssigned=false and onlyActive=false widen the result. Not paginated: everything comes back in one response.
• List List all HR WORKS wage and salary types List the wage types of the company (number, name, type, export key, country, active flag); onlyActive decides whether only active wage types are returned. Not paginated: everything comes back in one response.
• Get Get single HR WORKS wage payment job by ID Get the status and result of an asynchronous wage payment write. id is the jobId returned by wage_payments.create. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS wage payments List all wage payments (HR WORKS API v3): person uuid, month, gross amount, wage type and more; filter by wageTypeNumber. Paginated (page size not documented; limit is ignored); pass next_cursor with the same filters for the next page. HR WORKS documents page links only for v2, so paging may stop after page 1.
• Get Get single HR WORKS wage payment by ID Get one wage payment (HR WORKS API v3); id is the wage payment's uuid. Truto returns the data object of the v3 response. Returns: personUuid, monthYear, grossAmount, wageTypeNumber, remark, endMonthYear, interval.
• Create Create a HR WORKS wage payment Create wage payments in bulk: body {data: [...]} (HR WORKS documents no maximum). Each item needs personUuid, monthYear, grossAmount, wageTypeNumber. Asynchronous: returns a jobId; poll wage_payment_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS webhook job by ID Get the status and result of an asynchronous webhook write. id is the jobId returned by webhooks.create, webhooks.bulk_update, webhooks.bulk_delete. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS webhooks List the server-event webhooks of the company (id, name, resource, action, url, active flag); filter by resource (person, applicant, absence, sickLeave, remoteWork), action, or add inactive ones with onlyActive=false. Not paginated: everything comes back in one response.
• Create Create a HR WORKS webhook Create server-event webhooks in bulk: body {data: [...]} with 1-500 webhooks (HTTPS url, resource, action). Each item needs action, name, resource, url. Asynchronous: returns a jobId; poll webhook_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS webhooks bulk update Edit webhooks in bulk: body {data: [...]} with 1-500 items, each identified by its webhook id. Each item needs action, name, resource, url, id. Asynchronous: returns a jobId; poll webhook_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete HR WORKS webhooks bulk delete Delete webhooks by id: numbers lists 1-500 webhook ids, as returned by webhooks.list. Required: numbers. Asynchronous: returns a jobId; poll webhook_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Get Get single HR WORKS working time job by ID Get the status and result of an asynchronous working time write. id is the jobId returned by working_times.create, working_times.bulk_update, working_times.bulk_delete. The job is pending until HR WORKS has processed the write, then finished with the written records or the errors (write errors are reported here inside an HTTP 200). Kept for two weeks.
• List List all HR WORKS working time kiosks List the time-tracking kiosks (terminals) of the company: name, id and whether they use QR codes or PINs. Not paginated: everything comes back in one response.
• List List all HR WORKS working times List working times per person in a date range, with worked, target and break minutes per interval; filter by persons or types. Only persons with a time recording regulation in the range are returned. Required: beginDate and endDate (YYYY-MM-DD, at most one year apart; at most 31 days with interval=days). Each page is ONE object keyed by person identifier (`<key>` in the response schema is a placeholder, not a field) holding up to 50 persons; HR WORKS fixes the page size, so limit is ignored. Pass next_cursor with the same filters for the next page.
• Get Get single HR WORKS working time by ID Get one working time (HR WORKS API v3); id is the working time's uuid. Truto returns the data object of the v3 response. Returns: beginDateAndTime, endDateAndTime, beginDateTime, endDateTime, clockInKioskId, clockOutKioskId, comment, workingTimeType and more.
• Create Create a HR WORKS working time Create working times in bulk: body {data: [...]} with 1-1000 entries; deleteOverlappingWorkingTimes=true deletes existing working times that the new ones overlap. Each item needs beginDateAndTime. Asynchronous: returns a jobId; poll working_time_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Update HR WORKS working times bulk update Edit existing working times in bulk: body {data: [...]} with 1-1000 entries; deleteOverlappingWorkingTimes=true deletes other working times that the edited ones overlap. Each item needs beginDateAndTime. Asynchronous: returns a jobId; poll working_time_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).
• Delete HR WORKS working times bulk delete Delete working times: numbers lists 1-1000 working time numbers (personnel number, an underscore, then the begin time in Unix seconds, e.g. 1_1683093600). Required: numbers. Asynchronous: returns a jobId; poll working_time_jobs.get with it until the job is finished (write errors are reported there inside an HTTP 200).

No tools match your search.