v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Employments

Create an employee termination

Create a termination for an employee. The only things required are an effective date (their last day of work) and whether they should receive their wages in a one-off termination payroll or with the rest of the company.

Note that some states require employees to receive their final wages within 24 hours (unless they consent otherwise,) in which case running a one-off payroll may be the only option.

scope: employments:write

post/v1/employees/{employee_id}/terminations

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 employee's last day of work.

run_termination_payrollboolean

If true, the employee should receive their final wages via an off-cycle payroll. If false, they should receive their final wages on their current pay schedule.

Example request

{
  "effective_date": "2020-06-30",
  "run_termination_payroll": false
}

Response

Created

uuidstring required

The UUID of the termination object.

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 this termination is attached.

activeboolean

Whether the employee's termination has gone into effect.

cancelableboolean

Whether the employee's termination is cancelable. Cancelable is true if run_termination_payroll is false and effective_date is in the future.

effective_datestring

The employee's last day of work.

run_termination_payrollboolean

If true, the employee should receive their final wages via an off-cycle payroll. If false, they should receive their final wages on their current pay schedule.