Update an employee's state taxes

put https://api.gusto-demo.com/v1/employees/{employee_uuid}/state_taxes

Update attributes relevant for an employee's state taxes.

As described for the GET endpoint, the answers must be supplied in the effective-dated format, but currently only a single answer will be accepted - valid_from and valid_up_to must be "2010-01-01" and null respectively.

scope: employee_state_taxes:write

Responses

Response body

array of objects

object

employee_uuid

string

required

The employee's uuid

state

string

required

Two letter US state abbreviation

file_new_hire_report

boolean | null

is_work_state

boolean

questions

array of objects

required

questions*

object

label

string

required

A short title for the question

description

string

required

An explaination of the question - this may contain inline html formatted links.

key

string

required

A unique identifier of the question (for the given state) - used for updating the answer.

input_question_format

object

required

answers

array of objects

required

answers*

object

value

The answer to the corresponding question - this may be a string, number, boolean, or null.

valid_from

string

The effective date of the answer - currently always “2010-01-01”.

valid_up_to

string

The effective end date of the answer - currently always null.

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://api.gusto-demo.com/v1/employees/employee_uuid/state_taxes \
3
     --header 'X-Gusto-API-Version: 2024-04-01' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json'


xxxxxxxxxx
90
}
1
{
2
  "employee_uuid": "92fa4d30-e284-43d0-a26e-605619c04beb",
3
  "file_new_hire_report": false,
4
  "is_work_state": true,
5
  "state": "CA",
6
  "questions": [
7
    {
8
      "label": "Filing Status",
9
      "description": "The Head of Household status applies to unmarried individuals who have a relative living with them in their home. If unsure, read the <a target='_blank' data-bypass rel='noopener noreferrer' tabindex='99' href='https://www.ftb.ca.gov/file/personal/filing-status/index.html'>CA Filing Status explanation</a>.\n",
10
      "key": "filing_status",
11
      "input_question_format": {
12
        "type": "Select",
13
        "options": [
14
          {
15
            "value": "S",
16
            "label": "Single"
17
          },
18
          {
19
            "value": "M",
20
            "label": "Married one income"
21
          },
22
          {
23
            "value": "MD",
24
            "label": "Married dual income"
25
          },

200Example response

422Unprocessable Entity