v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Tax Requirements

Update tax requirements for a 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}.

Prerequisites

Retrieve current requirements via GET /v1/companies/{company_uuid}/tax_requirements/{state}
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

put/v1/companies/{company_uuid}/tax_requirements/{state}

Path parameters

company_uuidstring required

The UUID of the company

statestring required

The two-letter state abbreviation

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

{
  "requirement_sets": [
    {
      "key": "registrations",
      "state": "GA",
      "effective_from": "2022-01-01",
      "requirements": [
        {
          "key": "71653ec0-00b5-4c66-a58b-22ecf21704c5"
        }
      ]
    }
  ]
}

Response

Success