GUgusto
Jobs and Compensations

Create a job

Changed on

Create a job.

scope: jobs:write

post/v1/employees/{employee_id}/jobs

Request

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 nullable

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

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.

location_uuidstring

The uuid of the employee's work location.

Changes

  • f98575fa2a5eRevision changes
    • breaking

      the response property became nullable for the status

    • info

      added the optional property / to the response with the status

    • info

      the response's property default value was added for the status