Update a garnishment

Garnishments, or employee deductions, are fixed amounts or percentages deducted from an employee’s pay. They can be deducted a specific number of times or on a recurring basis. Garnishments can also have maximum deductions on a yearly or per-pay-period bases. Common uses for garnishments are court-ordered payments for child support or back taxes. Some companies provide loans to their employees that are repaid via garnishments.

scope: garnishments:write

garnishment_idstring required

The UUID of the garnishment

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

activeboolean

Whether or not this garnishment is currently active.

amountstring float

The amount of the garnishment. Either a percentage or a fixed dollar amount. Represented as a float, e.g. "8.00".

descriptionstring

The description of the garnishment.

court_orderedboolean

Whether the garnishment is court ordered.

The specific type of garnishment for court ordered garnishments.

timesinteger nullable

The number of times to apply the garnishment. Ignored if recurring is true.

recurringboolean

Whether the garnishment should recur indefinitely.

annual_maximumstring float nullable

The maximum deduction per annum. A null value indicates no maximum. Represented as a float, e.g. "200.00".

pay_period_maximumstring float nullable

The maximum deduction per pay period. A null value indicates no maximum. Represented as a float, e.g. "16.00".

deduct_as_percentageboolean

Whether the amount should be treated as a percentage to be deducted per pay period.

total_amountstring float nullable

A maximum total deduction for the lifetime of this garnishment. A null value indicates no maximum.

versionstring required

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

Example request

{
  "version": "56d00c178bc7393b2a206ed6a86afcb4"
}

Response

Example response

uuidstring required

The UUID of the garnishment in Gusto.

versionstring