These docs are for v2024-03-01. Click to read the latest docs for v2026-02-01.

Create an employee rehire

post

https://api.gusto-demo.com/v1/employees/{employee_id}/rehire

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

scope: employments:write

Path Params

employee_id

string

required

The UUID of the employee

Body Params

effective_date

string

required

The day when the employee returns to work.

file_new_hire_report

boolean

required

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

work_location_uuid

string

required

The uuid of the employee's work location.

employment_status

string

enum

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

Allowed:

two_percent_shareholder

boolean

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

Headers

X-Gusto-API-Version

string

enum

Defaults to 2024-03-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

404

Not Found

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

Language

Credentials

Bearer

Loading…

Response

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

application/json

201Example response

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.