Skip to main content

Fourth connector

Back to the connector overview, authentication methods, and actions.
​
2 Sept 2026
fix improvementCorrected the absence and holiday identifier contracts based on live API verification. Absence create, update and delete now explain that Fourth never returns an AbsenceID (List Absences returns the separate Reference identifier, which the mutation endpoints do not accept, and the importer discards client-supplied AbsenceIDs on create), and that holiday records — References prefixed HO in List Absences — are managed without any ID through Create Holiday and Delete Holiday keyed by employee number and date. List Import Logs gained the verified importType value absence, giving every absence mutation a checkable outcome, and now always sends its required query parameters, matching the gateway’s requirement that every documented parameter be present on the wire (absent parameters return HTTP 405). List Next of Kin gained the time-range filters it actually supports and now documents that a non-empty range is required. List Absences states the one-week ceiling per call explicitly, with instructions to chunk longer periods into consecutive weekly windows. Get Pay Parts Export by Employee spells out the two-step workflow of assembling its four path parameters from List Payroll Periods and List Employees.
fourth_create_absence, fourth_delete_absence, fourth_delete_holiday, fourth_get_pay_parts_export_by_employee, fourth_list_absences, fourth_list_import_logs, fourth_list_next_of_kin, fourth_update_absence
​
13 Aug 2026
improvementRelative time-range inputs now reject week and year units up front with a clear message instead of failing as a provider error, since Fourth supports only days and calendar months. List actions that take only optional filters now state that the query object must always be included in the call, because omitting it entirely is rejected before the request is made. Documented the response-size and filtering limits of the list actions so callers stop hitting truncated results and gateway timeouts. List Employees now explains that its time range filters by when a record last changed rather than by hire date, and that showFormer=false and no time range should be used to look up a specific person. List Absences and List Pay Parts now explain that each call covers the whole organisation and that the date range must be kept narrow enough to complete within the gateway timeout. List Next of Kin, List Accrual and List Employments now state that Fourth offers no pagination and no per-employee filter, so results must be matched client-side.
fourth_list_absences, fourth_list_accrual, fourth_list_addresses, fourth_list_country_specific, fourth_list_dependents, fourth_list_employees, fourth_list_employments, fourth_list_import_logs, fourth_list_next_of_kin, fourth_list_passports, fourth_list_pay_parts, fourth_list_payment_details, fourth_list_payroll_periods, fourth_list_payslips, fourth_update_employee
​
5 Aug 2026
bugfixFixed List Employees and List Next of Kin returning HTTP 400 (absent optional query parameters were sent as the literal string “null”). Corrected create/update/delete success messages for absences, holidays, and multiple employments to reflect that Fourth processes these asynchronously, so a SubmissionID does not confirm the change was applied. Clarified that relative time-range inputs accept only days and calendar months (weeks and years are not supported by the provider).
fourth_create_absence, fourth_create_holiday, fourth_create_multiple_employment, fourth_delete_absence, fourth_delete_holiday, fourth_list_absences, fourth_list_addresses, fourth_list_country_specific, fourth_list_dependents, fourth_list_employees, fourth_list_employments, fourth_list_import_logs, fourth_list_next_of_kin, fourth_list_passports, fourth_list_payment_details, fourth_list_payslips, fourth_update_absence
​
21 Jul 2026
guide-changesRenamed the authentication method to Basic Auth and updated the connection guide with instructions for obtaining credentials.