v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
People

Terminate company employee.

This changes the employee’s status to Terminated according to specified termination date. <br /> <p>Explore the <a href="https://apidocs.hibob.com/reference/people">People API</a> main reference page for information about rate limits, permissions, troubleshooting and more.</p>

post/employees/{identifier}/terminate

Path parameters

identifierstring required

The backend-id of the Employee. Retrieve this ID from the database. <br> For testing purposes, you can pull it from the URL in Bob when viewing the employee. For example, if the URL in Bob is "https://app.hibob.com/employee-profile/3332883884017713238" you should copy the "3332883884017713238".

Request body

terminationDatestring date required

The employee's termination date

terminationReasonstring

The ID of the 'terminationReason' list entry

reasonTypestring

The ID of the 'lifecycleReasonType' list entry

lastDayOfWorkstring date

Example request

{
  "terminationDate": "2025-09-23",
  "noticePeriod": {
    "unit": "days",
    "length": 30
  },
  "lastDayOfWork": "2025-09-22",
  "terminationReason": "Redundant",
  "reasonType": "End of Contract"
}

Response

Termination entry added successfully.