GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Update an employee's federal taxes

put
https://api.gusto-demo.com/v1/employees//federal_taxes

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

scope: employee_federal_taxes:write

Path Params
string
required

The UUID of the employee

Body Params
string
required

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

string
enum
required

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

Allowed:
number

Additional amount to be withheld from each paycheck.

boolean

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

number

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

number

Other income amount.

number

Deductions other than the standard deduction to reduce withholding.

string
enum
required

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

Allowed:
integer

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

number

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

Headers
string
enum
Defaults to 2026-02-01

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

Allowed:
Responses

Updated about 1 month ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago