v2025-06-15
To further improve performance of our payroll API endpoints, v2025-06-15
introduces the changes outlined below.
Added functionality to fetch employees of a company by UUIDs, and prepare a payroll by employee UUIDs
Updated GET /v1/companies/{company_id}/employees to let you fetch a company's employees by their UUIDs. Added functionality to PUT /v1/companies/{company_id}/payrolls/{payroll_id}/prepare to accept a list of employee UUIDs such that only those employee compensations will be prepared for update.
Improved notification to expose payroll UUID
We've added the payroll UUID as a resource in the bank_error.employee_ach_credit_failure
notification so partners can easily reconcile the relevant payroll whenever they receive this notification.
Added Get All Notifications endpoint
We've added an endpoint /v1/companies/{company_uuid}/notifications to fetch all notifications for a given company.
Added Xero and QuickBooks Online accounting integrations flows
We've launched our new Xero and QuickBooks Online (QBO) accounting integration flows, allowing your customers to seamlessly connect their payroll data with Xero or QBO. These integrations streamline the bookkeeping process by automatically creating balanced journal entries, eliminating manual data entry and reducing accounting errors.
Added PDF support for custom reports
We've added PDF support to our custom reports endpoint, giving you more flexibility in how you deliver reports to your customers. To use, include "file_type": "pdf" in your request body, as you would with the existing CSV and JSON file type options. Note that Generated PDFs will include Gusto branding.
Updated Benefits flow: how partner-managed benefits are displayed and managed
We've improved how benefits are displayed and managed in the benefits
flow to prevent data conflicts and make it clearer who manages each benefit.
Added fields to GET a notification's details
We've added two new fieldsβtemplate_variables
and status
βto GET /v1/notifications/{notification_uuid}.
General Ledger API now available
We've launched our new General Ledger API, allowing you to programmatically generate and retrieve general ledger reports for payrolls.
Added Information Requests API
The GET Information Requests API endpoint has been added. This API call can be used to return all requests for information (RFIs) for a company.