v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

External Payrolls

Update tax liabilities

Update tax liabilities for a company.

scope: external_payrolls:write

put/v1/companies/{company_uuid}/external_payrolls/tax_liabilities

Path parameters

company_uuidstring required

The UUID of the company

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

Example request

{
  "liability_selections": [
    {
      "tax_id": 1,
      "last_unpaid_external_payroll_uuid": "1bf1efe1-72d4-4e6e-a181-611f3ea66435",
      "unpaid_liability_amount": "47.5"
    }
  ]
}

Response

Success

tax_idinteger

The ID of the tax.

tax_namestring

The name of the tax.

descriptionstring nullable

A description of the tax, providing additional detail about the tax type.

last_unpaid_external_payroll_uuidstring nullable

The UUID of last unpaid external payroll.