v2026-02-01

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 Company endpoints:
    • Migrate company to embedded payroll
    • Check company migration readiness
  • 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
• Added new error category “migration_blocker” and warning category “migration_warning”
  • Affected Company endpoints:
    • Migrate company to embedded payroll
    • Check company migration readiness
• 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, and external_user_id, params are no longer required
• Updated Terms of Service endpoints to require payroll admin to accept and retrieve the terms of service. Affected endpoints include:
  • Accept terms of service for a company user
  • Retrieve terms of service status for a company user
• Payroll update requests with invalid versions will return a 409 status code instead of 422.
  • Affected endpoint:
    • Update a payroll by ID
• 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 Benefit endpoints:
    • Update an employee benefit
    • Create an employee benefit
    • Bulk update employee benefits for a company benefit
• Require email field for employee self-onboarding
  • Affected Employee endpoints:
    • Create an employee
• Deprecate the reverse_wire_detail_id metadata field surfaced in the wait_for_reverse_wire credit blocker
  • Affected endpoints:
    • Get a single payroll
    • Get all payrolls for a company
    • Get contractor payment groups for a company
    • Preview a contractor payment group
    • Get a contractor payment group