Update an employee's state taxes
PUT {{baseUrl}}/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
Request Body
{"states"=>[{"state"=>"<string>", "questions"=>[{"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}, {"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}]}, {"state"=>"<string>", "questions"=>[{"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}, {"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}]}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-Gusto-API-Version | string | Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used. | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"employee_uuid":"92fa4d30-e284-43d0-a26e-605619c04beb","file_new_hire_report":false,"is_work_state":true,"state":"CA","questions":[{"label":"Filing Status","description":"The Head of Household status applies to unmarried individuals who have a relative living with them in their home. If unsure, read the \u003ca target='_blank' data-bypass rel='noopener noreferrer' tabindex='99' href='https://www.ftb.ca.gov/file/personal/filing-status/index.html'\u003eCA Filing Status explanation\u003c/a\u003e.\n","key":"filing_status","input_question_format":{"type":"Select","options":[{"value":"S","label":"Single"},{"value":"M","label":"Married one income"},{"value":"MD","label":"Married dual income"},{"value":"H","label":"Head of household"},{"value":"E","label":"Do Not Withhold"}]},"answers":[{"value":"S","valid_from":"2010-01-01","valid_up_to":null}]},{"label":"Withholding Allowance","description":"This value is needed to calculate the employee's CA income tax withholding. If unsure, use the \u003ca target='_blank' data-bypass rel='noopener noreferrer' tabindex='99' href='http://www.edd.ca.gov/pdf_pub_ctr/de4.pdf'\u003eCA DE-4 form\u003c/a\u003e to calculate the value manually.\n","key":"withholding_allowance","input_question_format":{"type":"Number"},"answers":[{"value":1,"valid_from":"2010-01-01","valid_up_to":null}]},{"label":"Additional Withholding","description":"You can withhold an additional amount of California income taxes here.","key":"additional_withholding","input_question_format":{"type":"Currency"},"answers":[{"value":"0.0","valid_from":"2010-01-01","valid_up_to":null}]},{"label":"File a New Hire Report?","description":"State law requires you to file a new hire report within 20 days of hiring or re-hiring an employee.","key":"file_new_hire_report","input_question_format":{"type":"Select"},"answers":[{"value":true,"valid_from":"2010-01-01","valid_up_to":null}]}]}