Rehire a worker

Rehires a worker who was previously terminated and is eligible for rehire, restoring their existing profile rather than creating a new one.

Use this endpoint to rehire a worker whose hiring status came back as ELIGIBLE_FOR_REHIRE. It restores the worker's existing profile and links their new employment record to their prior payroll history, so their pay history, tax elections, and other historical data stay associated with a single worker profile.

When to use this endpoint

Only use this endpoint when the worker is returning to the same worker type they held before (for example, W-2 employee to W-2 employee).

If the rehire also involves a change in worker type — for example, a former contractor is returning as a W-2 employee, or vice versa — don't use this endpoint. Instead, follow the normal new-hire flow and create a new profile for the worker.

Rehire date

Provide a rehireDate equal to or later than the earliestValidHireDate returned for this worker by the hiring status lookup.

Position and compensation

employeeParams is only required when rehiring a W-2 employee, and describes their position and compensation going forward. It's ignored for worker types that don't require this information.

Path Params
string
required

The 'externalWorkerId' you assigned to the worker, or Everee's generated 'workerId' if you don't use your own IDs.

Body Params
date
required

The date, in the worker's local time zone, on which the rehire becomes effective.

int32

The ID of the approval group to assign this worker to.

boolean

Whether to use the worker's home address as their legal work location.

string

The ID of the "Work Location" record that represents the physical location where this worker performs their job. Values are ignored if "useHomeAddress" is "true", and required otherwise.

employeeParams
object

Position and compensation details for this worker. Only required when rehiring a W-2 employee.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
text/plain
application/json