Update a compensation

put

https://api.gusto-demo.com/v1/compensations/{compensation_id}

Compensations contain information on how much is paid out for a job. Jobs may have many compensations, but only one that is active. The current compensation is the one with the most recent effective_date.

scope: compensations:write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

compensation_id

string

required

The UUID of the compensation

Body Params

version

string

required

The current version of the object. See the versioning guide for information on how to use this field.

rate

string

The dollar amount paid per payment unit.

payment_unit

string

enum

The unit accompanying the compensation rate. If the employee is an owner, rate should be 'Paycheck'.

Allowed:

flsa_status

string

enum

The FLSA status for this compensation. Salaried ('Exempt') employees are paid a fixed salary every pay period. Salaried with overtime ('Salaried Nonexempt') employees are paid a fixed salary every pay period, and receive overtime pay when applicable. Hourly ('Nonexempt') employees are paid for the hours they work, and receive overtime pay when applicable. Commissioned employees ('Commission Only Exempt') earn wages based only on commission. Commissioned with overtime ('Commission Only Nonexempt') earn wages based on commission, and receive overtime pay when applicable. Owners ('Owner') are employees that own at least twenty percent of the company.

Allowed:

effective_date

string

The effective date for this compensation.

title

string

The job title for this compensation.

adjust_for_minimum_wage

boolean

Whether the compensation should be adjusted to minimum wage during payroll calculation.

minimum_wages

array of objects

minimum_wages

Headers

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful

404Not Found The requested resource does not exist. Make sure the provided UUID is valid.

422Unprocessable Entity This may happen when the body of your request contains errors such as invalid_attribute_value, or the request fails due to an invalid_operation. See the Errors Categories guide for more details.