---
title: "Add/update additional rates"
method: PUT
path: "/v2/companies/{companyId}/employees/{employeeId}/additionalRates"
tags: ["Additional Rates"]
---

# Add/update additional rates

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

## Request

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

Sends new or updated employee additional rates information directly to Web Pay.

## Path parameters

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

## Request body

- AdditionalRate: The additional pay rate model
  - `changeReason` string, nullable: Not required. If populated, must match one of the system coded values available in the Additional Rates Change Reason drop down.<br />
  - `costCenter1` string, nullable: Not required. Valid values must match one of the system coded cost centers available in the Additional Rates Cost Center level 1 drop down. This cell must be in a text format.<br />
  - `costCenter2` string, nullable: Not required. Valid values must match one of the system coded cost centers available in the Additional Rates Cost Center level 2 drop down. This cell must be in a text format.<br />
  - `costCenter3` string, nullable: Not required. Valid values must match one of the system coded cost centers available in the Additional Rates Cost Center level 3 drop down. This cell must be in a text format.<br />
  - `effectiveDate` string, paylocity-date, nullable: Required. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.<br />
  - `endCheckDate` string, paylocity-date, nullable: Not required. Must match one of the system coded check dates available in the Additional Rates End Check Date drop down. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.<br />
  - `job` string, nullable: Not required. If populated, must match one of the system coded values available in the Additional Rates Job drop down.<br />
  - `rate` number, nullable: Required. Enter dollar amount that corresponds to the Per selection.<br />
  - `rateCode` string, nullable: Required. If populated, must match one of the system coded values available in the Additional Rates Rate Code drop down.<br />
  - `rateNotes` string, nullable: Not required.<br />Max length: 4000<br />
  - `ratePer` string, nullable: Required. Valid values are HOUR or WEEK.<br />
  - `shift` string, nullable: Not required. If populated, must match one of the system coded values available in the Additional Rates Shift drop down.<br />

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