v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Jobs and Compensations

Create a job

Create a job.

scope: jobs:write

post/v1/employees/{employee_id}/jobs

Path parameters

employee_idstring required

The UUID of the employee

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

titlestring nullable

The job title.

hire_datestring

The date when the employee was hired or rehired for the job.

two_percent_shareholderboolean

Whether the employee owns at least 2% of the company.

state_wc_coveredboolean nullable

Whether this job is eligible for workers' compensation coverage in the state of Washington (WA).

state_wc_class_codestring nullable

The risk class code for workers' compensation in Washington state. Please visit Washington state's Risk Class page to learn more.

Example request

{
  "title": "Regional Manager",
  "hire_date": "2020-12-21"
}

Response

created a primary job with a null title

uuidstring required

The UUID of the job.

versionstring

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

employee_uuidstring

The UUID of the employee to which the job belongs.

hire_datestring

The date when the employee was hired or rehired for the job.

titlestring nullable

The title for the job.

primaryboolean

Whether this is the employee's primary job. The value will be set to true unless an existing job exists for the employee.

ratestring

The employee's pay rate for this job (e.g., hourly wage or annual salary). This is sensitive compensation data and requires the compensations:read scope.

payment_unitstring nullable

How the employee is paid for this job (e.g., Hour, Week, Month, Year, Paycheck). This is sensitive compensation data and requires the compensations:read scope.

current_compensation_uuidstring

The UUID of the current active compensation record for this job. Requires the compensations:read scope.