# Transfer employee ownership to a new person

Suspends (or deletes) the existing employee account and provisions a new employee in its place, inheriting the same team and supervisor. Requires the caller to have PEOPLE_EDIT permission.

Endpoint: POST /employees/transfer-ownership
Version: 2.0.0
Security: oauth2ClientCredentials

## Header parameters:

  - `org_wallet_ref` (string)
    Organization wallet reference, defaults to "1" if not provided

  - `business_id` (string, required)
    Business identifier for the request

## Request fields (application/json):

  - `employee_id` (string)
    ID of the existing employee to transfer ownership from. Either employee_id or external_id is required.
    Example: abc123xyz

  - `external_id` (string)
    External employee ID (alternative identifier). Either employee_id or external_id is required.
    Example: ext-456

  - `name` (string, required)
    Full name of the new employee taking ownership
    Example: John Mwangi

  - `email` (string, required)
    Email address of the new employee. Must not be in use by any active user.
    Example: john.mwangi@company.com

  - `phone` (string, required)
    Phone number of the new employee in international format. Must not be in use by any active user.
    Example: +254798765432

  - `new_status` (string)
    Status to set on the old employee record after the transfer completes. Defaults to SUSPENDED.
    Enum: "SUSPENDED", "DELETED"

## Response 200 fields (application/json):

  - `new_employee_id` (string, required)
    Employee ID of the newly created employee
    Example: xyz789abc123

  - `old_employee_status` (string, required)
    Status that was applied to the old employee record
    Enum: "SUSPENDED", "DELETED"