---
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`

## Request

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

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.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)