GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Create a historical employee

post
https://api.gusto-demo.com/v1/companies//historical_employees

Create a historical employee, an employee that was previously dismissed from the company in the current year.

scope: employees:manage

Path Params
string
required

The UUID of the company

Body Params

Create a historical employee.

string
required
string
string
required
string
string
required
string
required
work_address
object
required
home_address
object
required
termination
object
required
string

Optional. If provided, the email address will be saved to the employee.

job
object
required
employee_state_taxes
object
Headers
string
enum
Defaults to 2026-02-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.

Updated 5 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago