For AI agents: visit https://docs.gusto.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.
Jump to Content
Guides
API Reference
Changelog
API Status
API Policy
Gusto Security
v2024-03-01
v2024-04-01
v2025-06-15
v2025-11-15
v2026-02-01
v2026-06-15
Guides
v2026-02-01
Guides
API Reference
Changelog
API Status
API Policy
Gusto Security
Submit Feedback
These docs are for v2026-02-01. Click to read the latest docs for v2026-06-15.
Getting started
Introduction
Platform overview
Quickstart
Getting started
Payroll fundamentals
Developer tools
Authentication and authorization
Postman
API versioning
What is a breaking change?
Version upgrade guide
API fundamentals
Errors
Error Categories
Webhooks
Best Practices
Webhook Events
Bank Account Events
Company Events
Company Benefit Events
Contractor Events
Contractor Payment Events
Contractor Payment Group Events
Employee Events
Employee Home Address Events
Employee Work Address Events
Employee Benefit Events
Employee Job Compensation Events
External Payroll Events
Fast Ach Config Events
Form Events
Document Events
Generated Document Events
Location Events
Notification Events
Payroll Events
Pay Schedule Events
Signatory Events
Time Off Request Events
Partner notifications
Partner Notification types
Testing Partner Notifications
Dev Assistant MCP
Build options
Introduction
React SDK
API Clients
Gusto Flows (pre-built UI)
Flows quickstart
Customize flows
Flow types
Try it now
Flow events
Companies
Introduction
Onboard a company
Migrate an existing company
Onboard a contractor-only company
Manage company locations
Manage company bank accounts
Create company benefits
Company forms
Manage company attachments
Create a department
Time off requests
People management
Introduction
Manage W-2 employees
Onboard a W-2 employee
Onboarding Method Comparison
Employee self-onboarding
Manage jobs and compensation
Adjust for minimum wage
Configure employee tax information
W2 employee forms
I-9 employment verification
I-9 Verification Using Flows
Manage employee addresses
Calculate a reasonable salary for S Corp owner-employees
Terminate a W2 Employee
Rehire a W2 Employee
Manage recurring reimbursements
Create a child support garnishment
Manage employee benefits
Benefit effective dating
People Batch API
Create a people batch
Person data
Home address
Work address
Job
Compensation
Bank accounts and direct deposit splits
Department information
Get the status of a people batch
People batch webhooks
Manage contractors
Onboard a Contractor
Contractor self-onboarding
Deactivate a contractor
Pay contractors
Contractor Payment Receipts
Contractor payment group submission blockers
Manage contractor forms and documents
Contractor forms
Contractor documents
Time off policies
Manage time off policies
Accrual methods
Time off management flow
Create a holiday pay policy
Payrolls
Introduction
Payroll Processing Speeds
Recovery Cases
Calculate An Employee's Gross Wage
Complete a Regular Payroll
Payroll Statuses
Payroll Receipts
Payroll Blockers
Payroll Submission Blockers & Unblock Options
Payroll Processing Request
Create an Off Cycle Payroll
Create a Termination Payroll Flow
Create Company Specific Custom Earnings
Create a Historical Payroll
Pay Schedules
Create a pay schedule
Manage Pay Schedules via API
Manage Pay Schedules Flow
Generate Printable Paper Checks
Gross-Up
Payroll Digests API
Reports
Generate Custom Reports
Retrieve a General Ledger report
ACH TRANSACTIONS
ACH Transactions
ACH Codes and Transaction Types
Bank Errors
Product Partnerships
Health Insurance (SimplyInsured)
On-Demand Pay (Clair)
Workers' Compensation (NEXT)
401(k) (Guideline)
Accounting integrations (Xero and QuickBooks Online)
Contact
Submit Feedback
Contact Gusto
Submit Feedback
Copy Page
