These docs are for v2024-03-01. Click to read the latest docs for v2025-06-15.
added

Added rate limit headers

Added additional rate limit data to API response headers. The following headers are now available to use when handling rate limiting programmatically:

added

Added webhooks

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

improved

v2025-06-15

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

improved

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

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

Added Get All Notifications endpoint

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

added

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.

improved

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.

improved

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.