Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Contractors

Schedule a contractor termination

Purpose

Schedules a contractor dismissal for a given date. Supports both immediate (past dates) and future-dated dismissals.

Prerequisites

Before calling this endpoint:

  1. The contractor must be active (no existing pending dismissal)
  2. The contractor must have a current employment

Related webhooks

  • contractor.deactivated: Fires when the contractor becomes inactive (on or after end_date)

scope: contractors:write

post/v1/contractors/{contractor_uuid}/termination

Path parameters

contractor_uuidstring required

The UUID of the contractor

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

end_datestring date required

The date of dismissal

Example request

{
  "end_date": "2025-06-15"
}

Response

no content