---
title: "Add/update non-primary state tax"
method: PUT
path: "/v2/companies/{companyId}/employees/{employeeId}/nonprimaryStateTax"
tags: ["Non-Primary State Tax"]
---

# Add/update non-primary state tax

`PUT /v2/companies/{companyId}/employees/{employeeId}/nonprimaryStateTax`

Sends new or updated employee non-primary state tax information directly to Web Pay.

## Path parameters

- `companyId` string, required
- `employeeId` string, required

## Request body

- NonPrimaryStateTax — The Non-Primary State Tax model
  - `amount` number, nullable — State tax code.<br /> Max length: 50
  - `deductionsAmount` number — Box 4(b) on form W4 (year 2020 or later): Deductions amount. <br />Decimal (12,2)
  - `dependentsAmount` number — Box 3 on form W4 (year 2020 or later): Total dependents amount. <br />Decimal (12,2)
  - `exemptions` number, nullable — State tax exemptions value.<br />Decimal (12,2)
  - `exemptions2` number, nullable — State tax exemptions 2 value.<br />Decimal (12,2)
  - `filingStatus` string, nullable — Employee state tax filing status. Common values are *S* (Single), *M* (Married).<br />Max length: 50
  - `higherRate` boolean — Box 2(c) on form W4 (year 2020 or later): Multiple Jobs or Spouse Works. <br />Boolean
  - `otherIncomeAmount` number — Box 4(a) on form W4 (year 2020 or later): Other income amount. <br />Decimal (12,2)
  - `percentage` number, nullable — State Tax percentage. <br />Decimal (12,2)
  - `reciprocityCode` string, nullable — Non-primary state tax reciprocity code.<br /> Max length: 50
  - `specialCheckCalc` string, nullable — Supplemental check calculation code. Common values are *Blocked* (Taxes blocked on Supplemental checks), *Supp* (Use supplemental Tax Rate-Code). <br />Max length: 10
  - `taxCalculationCode` string, nullable — Tax calculation code. Common values are *F* (Flat), *P* (Percentage), *FDFP* (Flat Dollar Amount plus Fixed Percentage). <br />Max length: 10
  - `taxCode` string, nullable — State tax code.<br /> Max length: 50
  - `w4FormYear` integer — The state W4 form year <br />Integer

## Response `200`

Successfully added or updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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