---
title: "Update tax requirements for a state"
method: PUT
path: "/v1/companies/{company_uuid}/tax_requirements/{state}"
tags: ["Tax Requirements"]
---

# Update tax requirements for a state

`PUT /v1/companies/{company_uuid}/tax_requirements/{state}`

## Request

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

Updates the tax requirement answers for a specific state. Submit answers to the requirement questions returned
by [GET /v1/companies/{company_uuid}/tax_requirements/{state}](ref:get-v1-companies-company_uuid-tax_requirements-state).

### Prerequisites

1. Retrieve current requirements via [GET /v1/companies/{company_uuid}/tax_requirements/{state}](ref:get-v1-companies-company_uuid-tax_requirements-state)
2. Ensure that each requirement set that you're updating includes the correct `key`, `state`, and `effective_from` values from the GET response

scope: `company_tax_requirements:write`

## Path parameters

- `company_uuid` string, required
- `state` string, required

## Headers

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

## Request body

- object
  - `requirement_sets` object[]: Array of requirement sets to update. Each set corresponds to a category of requirements for the state.
    - `key` string, required: An identifier for a set of requirements. A list of requirement sets can contain multiple sets with the same `key` and different `effective_from` values.
    - `state` string, required: One of the two-letter state abbreviations for the fifty United States and the District of Columbia (DC)
    - `effective_from` string, nullable: An ISO 8601 formatted date representing the date values became effective. Some requirement sets are effective dated, while others are not. Multiple requirement sets for the same state/key can/will exist with unique effective dates. If a requirement set is has an `effective_from` value, all requirement sets with the same key will also have an `effective_from` value.
    - `requirements` object[]
      - `key` string, required: An identifier for an individual requirement. Uniqueness is guaranteed within a requirement set.
      - `value` union: The value or "answer" for a tax requirement. Type depends on the requirement metadata type (e.g. string for text/account_number, boolean for radio/checkbox, number for percent/currency/tax_rate). Null when the requirement has not been answered.
        - boolean
        - string
        - number

## Response `200`

Success

## 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)