Sign in

v1

latestOpenAPI 3.0.42026-07-2481154567.6 KB
Non-Primary State Tax

Upsert Non-Primary State Tax

Sends new or updated employee non-primary state tax information directly to Paylocity Payroll/HR solution.

put/v2/companies/{companyId}/employees/{employeeId}/nonprimaryStateTax

Path parameters

companyIdstring required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity. Allowable Values: 9 char max

employeeIdstring required

The Paylocity Employee ID. This is a unique value per Paylocity Company ID. Allowable Values: 10 char max

Request body

amountnumber

State tax code.<br /> Max length: 50

deductionsAmountnumber

Box 4(b) on form W4 (year 2020 or later): Deductions amount. <br />Decimal (12,2)

dependentsAmountnumber

Box 3 on form W4 (year 2020 or later): Total dependents amount. <br />Decimal (12,2)

exemptionsnumber

State tax exemptions value.<br />Decimal (12,2)

exemptions2number

State tax exemptions 2 value.<br />Decimal (12,2)

filingStatusstring

Employee state tax filing status. Common values are S (Single), M (Married).<br />Max length: 50

higherRateboolean

Box 2(c) on form W4 (year 2020 or later): Multiple Jobs or Spouse Works. <br />Boolean

otherIncomeAmountnumber

Box 4(a) on form W4 (year 2020 or later): Other income amount. <br />Decimal (12,2)

percentagenumber

State Tax percentage. <br />Decimal (12,2)

reciprocityCodestring

Non-primary state tax reciprocity code.<br /> Max length: 50

specialCheckCalcstring

Supplemental check calculation code. Common values are Blocked (Taxes blocked on Supplemental checks), Supp (Use supplemental Tax Rate-Code). <br />Max length: 10

taxCalculationCodestring

Tax calculation code. Common values are F (Flat), P (Percentage), FDFP (Flat Dollar Amount plus Fixed Percentage). <br />Max length: 10

taxCodestring

State tax code.<br /> Max length: 50

w4FormYearinteger

The state W4 form year <br />Integer

Response

Successfully added or updated