v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Benefits

Update a Section 603 high earner status

Update a Section 603 high earner status for an employee for a specific year.

Section 603 of the SECURE 2.0 Act applies to employees aged 50 or older whose prior-year FICA wages exceed the IRS threshold. These employees are classified as high earners, and their catch-up contributions to pre-tax retirement benefits must be designated as post-tax contributions.

scope: employee_benefits:write

patch/v1/employees/{employee_uuid}/section603_high_earner_statuses/{effective_year}

Path parameters

employee_uuidstring required

The UUID of the employee

effective_yearinteger required

The effective year for the Section 603 status

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

is_high_earnerboolean required

Whether the employee is classified as a high earner for Section 603 purposes

Example request

{
  "is_high_earner": true
}

Response

successful

idstring required

The unique identifier of the Section 603 high earner status record

effective_yearinteger required

The year for which this high earner status applies

is_high_earnerboolean nullable required

Whether the employee is classified as a high earner for Section 603 purposes. Can be null if the status has not yet been determined.