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

# Add/update primary state tax

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

## Request

- Base URL: `https://api.paylocity.com/api`
- URL: `https://api.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}/primaryStateTax`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.paylocity.com/IdentityServer/connect/token` scopes: `WebLinkAPI`

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

## Path parameters

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

## Request body

- StateTax: The 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)
  - `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.dev/paylocity/apis/paylocity-api.md) - [All operations](https://skmtc.dev/paylocity/apis/paylocity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/paylocity-api/revisions/4e4bf910efae?raw)