Employment Status

Overview

When you create a new employment through Remote API, in its response, there is a status field which indicates the current state of the employment at a given time. Let's take a look at its possible values:

Employment StatusDescriptionWebhook event
createdIndicates that the employment has been created. At this stage, employer can edit employee's data.
created_awaiting_reserveIndicates that the employment has been created but Remote is waiting for a reserve payment before an employer can invite the employee.
created_reserve_paidIndicates that the reserve payment has been paid by the employer.
invitedIndicates that the employee has been invited but didn't start the onboarding process. At this stage, employer can no longer make changes to the employee's contract details.employment.user_status.invited
initiated

Indicates that the employee has started their onboarding.
On completion of every onboarding task, the

employment.onboarding_task.completed

event is triggered.

employment.user_status.initiated
reviewIndicates that the employee has completed onboarding and are being reviewed by the Remote admin.
pendingIndicates that employment is missing necessary fields while onboarding.
active

Indicates that the employment is active. The status is set to active when all user tasks are completed and the user status is also active. (Learn more about user statuses in the next section).
On active, the

employment.onboarding.completed

event is triggered.

employment.user_status.activated
archivedIndicates that the employment has been archived and no longer in use. When an employment is marked as archived, the user status changes to inactive.
deletedIndicates that the employment has been soft deleted by the admin. Accounts are deleted at the request of the users. When this is done, the user will no longer appear on the team page.