Changelog

Added company.unsuspended, contractor.reactivated, and ContractorPaymentGroup webhooks: contractor_payment_group.created and contractor_payment_group.cancelled.

To further improve performance of our payroll API endpoints, v2025-06-15 introduces the changes outlined below.

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.

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.

We've added an endpoint /v1/companies/{company_uuid}/notifications to fetch all notifications for a given company.

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.

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.

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.

We've added two new fields—template_variables and status—to GET /v1/notifications/{notification_uuid}.

We've launched our new General Ledger API, allowing you to programmatically generate and retrieve general ledger reports for payrolls.