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

# Add/update employee's benefit setup

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

Sends new or updated employee benefit setup information directly to Web Pay.

## Path parameters

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

## Request body

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