---
title: "Upsert Employee's Benefit Setup"
method: PUT
path: "/v2/companies/{companyId}/employees/{employeeId}/benefitSetup"
tags: ["Employee Benefit Setup"]
---

# Upsert Employee's Benefit Setup

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

Sends new or updated employee benefit setup information directly to Paylocity Payroll/HR solution.

## Path parameters

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

## Request body

- BenefitSetup — The benefit setup model
  - `benefitClass` string — Benefit Class code. Values are configured in Paylocity Payroll/HR solution Company > Setup > Benefits > Classes.<br />Max length: 30
  - `benefitClassEffectiveDate` string, paylocity-date — Date when Benefit Class takes effect. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.
  - `benefitSalary` number — Salary used to configure benefits.<br />Decimal(12,2)
  - `benefitSalaryEffectiveDate` string, paylocity-date — Date when Benefit Salary takes effect. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.
  - `doNotApplyAdministrativePeriod` boolean — Applicable only for HR Enhanced clients and Benefit Classes with ACA Employment Type of Full Time.
  - `isMeasureAcaEligibility` boolean — Only valid for HR Enhanced clients and Benefit Classes that are ACA Employment Type of Full Time.

## 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/assessments-api.md) · [All operations](https://skmtc.net/paylocity/apis/assessments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylocity/assessments-api/revisions/dd22ab229153/schema)