v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Employee Tax Setup

Update an employee's state taxes

Update attributes relevant for an employee's state taxes.

As described for the GET endpoint, the answers must be supplied in the effective-dated format, but currently only a single answer will be accepted. The valid_from and valid_up_to fields are optional and currently ignored.

scope: employee_state_taxes:write

put/v1/employees/{employee_uuid}/state_taxes

Path parameters

employee_uuidstring required

The UUID of the employee

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

Response

successful

uuidstring

The uuid of the employee state field.

employee_uuidstring

The employee's uuid

statestring

Two letter US state abbreviation

file_new_hire_reportboolean nullable
is_work_stateboolean