Added
v2026-02-01
10 days ago by Gusto Developer Relations
This is the changelog for v2026-02-01, which contains breaking changes.
To learn more about versions in our API, check out our Versioning and Version upgrade guides.
Endpoint updates
- Adds new blockers and warnings to the migrate and migration readiness endpoints
- Affected
Companyendpoints: - List of blockers:
- Marijuana business warning
- Gusto managed benefits blocker
- Time off policies unsupported blocker
- Company suspended blocker
- Integrations unsupported warning
- Terms of service not signed by payroll admin blocker
- Tier unsupported blocker
- Affected
- Added new error category “migration_blocker” and warning category “migration_warning”
- Affected
Companyendpoints:
- Affected
- Updated response structure for the Migrate company to embedded payroll endpoint:
- “migration_status” is now a boolean instead of a string
- Warnings are included with the success response
- Remove the signing of the terms of service in the Migrate an existing company endpoint and introduce a migration blocker when the terms of service is not signed by a company payroll admin
- The
email,ip_address, andexternal_user_id, params are no longer required
- The
- Updated Terms of Service endpoints to require payroll admin to accept and retrieve the terms of service. Affected endpoints include:
- Payroll update requests with invalid versions will return a 409 status code instead of 422.
- Affected endpoint:
- Update benefit now validates on presence or auto-populates the elective parameter for Simple IRA employee benefits. If elective is provided, validates it matches the expected value for the benefit type (true for simple IRA benefits and false for non-elective simple IRAs).
- If elective is not provided, auto-sets it based on the benefit type.
- Affected
Benefitendpoints:
- Require email field for employee self-onboarding
- Affected
Employeeendpoints:
- Affected
- Deprecate the
reverse_wire_detail_idmetadata field surfaced in thewait_for_reverse_wirecredit blocker