Add/update non-primary state tax

put https://dc1demogw.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}/nonprimaryStateTax

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

Path Params

companyId

string

required

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

employeeId

string

required

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

Body Params

Non-Primary State Tax Model

amount

number

State tax code.
Max length: 50

deductionsAmount

number

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

dependentsAmount

number

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

exemptions

number

State tax exemptions value.
Decimal (12,2)

exemptions2

number

State tax exemptions 2 value.
Decimal (12,2)

filingStatus

string

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

higherRate

boolean

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

otherIncomeAmount

number

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

percentage

number

State Tax percentage.
Decimal (12,2)

reciprocityCode

string

Non-primary state tax reciprocity code.
Max length: 50

specialCheckCalc

string

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

taxCalculationCode

string

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

taxCode

string

State tax code.
Max length: 50

w4FormYear

integer

The state W4 form year
Integer

Responses

200

Successfully added or updated

401

Unauthorized

403

Forbidden

429

Too Many Requests

Language

Credentials

OAuth2


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://dc1demogw.paylocity.com/api/v2/companies/companyId/employees/employeeId/nonprimaryStateTax \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Choose an example:

application/json

400Bad Request

500Internal Server Error