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

## Request

- Base URL: `https://dc1demogw.paylocity.com/api`
- URL: `https://dc1demogw.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 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.dev/paylocity/apis/weblink-api.md) - [All operations](https://skmtc.dev/paylocity/apis/weblink-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/weblink-api/revisions/8152ed40b412?raw)