v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Tax Setup

Update federal taxes for an employee

Updates federal tax (W4) information for an employee. Only rev_2020_w4 format is accepted for updates.

scope: employee_federal_taxes:write

put/v1/employees/{employee_uuid}/federal_taxes

employee_uuidstring required

The UUID of the employee

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.

versionstring required

The current version of the object. See the versioning guide for information on how to use this field.

w4_data_type'rev_2020_w4' required

The version of the W4 form. Only rev_2020_w4 is accepted for updates.

filing_status'Single' | 'Married' | 'Head of Household' | 'Exempt from withholding' required

Determines which tax return form an individual will use. One of: Single, Married, Head of Household, Exempt from withholding.

two_jobsboolean

If there are only two jobs (e.g., you and your spouse each have a job), set to true.

dependents_amountnumber

Amount for dependents; a dependent entitles the taxpayer to claim a dependency exemption.

other_incomenumber

Other income amount.

deductionsnumber

Deductions other than the standard deduction to reduce withholding.

extra_withholdingnumber

Additional amount to be withheld from each paycheck.

federal_withholding_allowanceinteger

Only applicable when w4_data_type is 'pre_2020_w4' (pre-2020 W4 forms are deprecated for updates).

additional_withholdingnumber

Only applicable when w4_data_type is 'pre_2020_w4' (pre-2020 W4 forms are deprecated for updates).

{
  "version": "56a489ce86ed6c1b0f0cecc4050a0b01",
  "filing_status": "Single"
}

Successful