---
title: "Set Employee Tax Parameters"
method: POST
path: "/employees/setTaxParameters"
---

# Set Employee Tax Parameters

`POST /employees/setTaxParameters`

Set an employee's tax withholding parameters.

## Request body

- object
  - `employeeID` string, required — ID of the Employee being updated
  - `companyID` string, required — ID of the company that the employee belongs to
  - `federalParameters` object[], required — An array of Tax Parameter entries
    - `code` string — Codename of tax parameter
    - `value` string — Value you want to set for the given tax parameter
    - `jurisdiction` string — "US" for federal or a State (2 level abbreviation)
    - `effectiveDate` string, date — Effective date of the tax parameter. Only accepts YYYY-MM-DD date format.
  - `stateParameters` object[] — An array of state Tax Parameter entries
    - `code` string — Codename of tax parameter
    - `value` string — Value you want to set for the given tax parameter
    - `jurisdiction` string — "US" for federal or a State (2 level abbreviation)
    - `effectiveDate` string, date — Effective date of the tax parameter. Only accepts YYYY-MM-DD date format.
  - `effectiveDate` string, date — Effective Date of the tax parameters in this request. Only accepts YYYY-MM-DD date format. This effective date will apply to any net new changed parameters unless the date is explicitly declared in the individual parameter object. **Note: Will default to the time of the request**

## Response `200`

200

- object
  - `success` boolean
  - `data` object
    - `employeeID` string
    - `federalParameters` object[]
      - `_id` string
      - `code` string
      - `value` string
      - `jurisdiction` string
      - `effectiveDate` string
    - `stateParameters` object[]
      - `_id` string
      - `code` string
      - `value` string
      - `jurisdiction` string
      - `effectiveDate` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/zeal/apis/zeal-api.md) · [All operations](https://skmtc.net/zeal/apis/zeal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeal/zeal-api/revisions/01346dceb27d/schema)