---
title: "Update tax liabilities"
method: PUT
path: "/v1/companies/{company_uuid}/external_payrolls/tax_liabilities"
tags: ["External Payrolls"]
---

# Update tax liabilities

`PUT /v1/companies/{company_uuid}/external_payrolls/tax_liabilities`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/external_payrolls/tax_liabilities`
- Auth: HTTP bearer

Update tax liabilities for a company.

scope: `external_payrolls:write`

## Path parameters

- `company_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- TaxLiabilitySelectionsRequest: The request body for updating tax liability selections.
  - `liability_selections` object[], required: Tax liability selections to record for the company's external payrolls.
    - `tax_id` integer, required: The ID of the tax.
    - `last_unpaid_external_payroll_uuid` string, nullable, required: The UUID of the last external payroll with an unpaid liability for this tax. Set to `null` to indicate no liability.
    - `unpaid_liability_amount` string, float, required: The total cumulative unpaid liability amount for this tax across all external payrolls up to and including the one specified by `last_unpaid_external_payroll_uuid`.

## Response `200`

Success

- TaxLiabilitiesSelections[]
  - `tax_id` integer: The ID of the tax.
  - `tax_name` string: The name of the tax.
  - `description` string, nullable: A description of the tax, providing additional detail about the tax type.
  - `last_unpaid_external_payroll_uuid` string, nullable: The UUID of last unpaid external payroll.
  - `possible_liabilities` object[]: Possible tax liabilities selections.
    - `liability_amount` string: Liability amount.
    - `payroll_check_date` string, nullable: The external payroll check date.
    - `external_payroll_uuid` string, nullable: The UUID of the external payroll.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)