Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Jobs and Compensations

Create a compensation

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.

Prerequisites

Before calling this endpoint:

  1. A job must exist for the employee

Webhooks

  • employee_job_compensation.created: Fires when a compensation is successfully created

scope: compensations:write

post/v1/jobs/{job_id}/compensations

Path parameters

job_idstring required

The UUID of the job

Headers

X-Gusto-API-Version'2026-06-15'

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

Request body

ratestring

The dollar amount paid per payment unit.

payment_unit'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck'

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

flsa_status'Exempt' | 'Salaried Nonexempt' | 'Nonexempt' | 'Owner' | 'Commission Only Exempt' | 'Commission Only Nonexempt'

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.

effective_datestring

The effective date for this compensation.

titlestring

The job title for this compensation.

adjust_for_minimum_wageboolean

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

Example request

{
  "rate": "70000.00",
  "payment_unit": "Year",
  "effective_date": "2023-01-01",
  "title": "Software Engineer"
}

Response

Successful

uuidstring required

The UUID of the compensation in Gusto.

versionstring

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

job_uuidstring

The UUID of the job to which the compensation belongs.

employee_uuidstring

The UUID of the employee to which the compensation belongs.

ratestring

The dollar amount paid per payment unit.

payment_unit'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck'

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

flsa_status'Exempt' | 'Salaried Nonexempt' | 'Nonexempt' | 'Owner' | 'Commission Only Exempt' | 'Commission Only Nonexempt'

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.

titlestring

The job title for this compensation.

effective_datestring

The effective date for this compensation. For the first compensation, this defaults to the job's hire date.

adjust_for_minimum_wageboolean

Indicates if the compensation could be adjusted to minimum wage during payroll calculation.