v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Employee Employments

Create an employee rehire

Rehire is created whenever an employee is scheduled to return to the company.

scope: employments:write

post/v1/employees/{employee_id}/rehire

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

effective_datestring required

The day when the employee returns to work.

file_new_hire_reportboolean required

The boolean flag indicating whether Gusto will file a new hire report for the employee.

work_location_uuidstring required

The uuid of the employee's work location.

employment_status'part_time' | 'full_time' | 'part_time_eligible' | 'variable' | 'seasonal' | 'not_set'

The employee's employment status. Supplying an invalid option will set the employment_status to not_set.

two_percent_shareholderboolean

Whether the employee is a two percent shareholder of the company. This field only applies to companies with an S-Corp entity type.

Example request

{
  "effective_date": "2023-06-30",
  "work_location_uuid": "b6ae9d93-d4b8-4119-8c96-dba595dd8c30"
}

Response

Created

versionstring

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

effective_datestring

The day when the employee returns to work.

file_new_hire_reportboolean

The boolean flag indicating whether Gusto will file a new hire report for the employee.

work_location_uuidstring

The uuid of the employee's work location.

employment_status'part_time' | 'full_time' | 'part_time_eligible' | 'variable' | 'seasonal' | 'not_set'

The employee's employment status. Supplying an invalid option will set the employment_status to not_set.

two_percent_shareholderboolean

Whether the employee is a two percent shareholder of the company. This field only applies to companies with an S-Corp entity type.

employee_uuidstring

The UUID of the employee.

activeboolean

Whether the employee's rehire has gone into effect.