---
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}`

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}](https://docs.gusto.com/embedded-payroll/reference/get-v1-companies-company_uuid-tax_requirements-state).

### Prerequisites

1. Retrieve current requirements via [GET /v1/companies/{company_uuid}/tax_requirements/{state}](https://docs.gusto.com/embedded-payroll/reference/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.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)