---
title: 'Employee onboarding'
summary: 'The guided multi-step form for adding a new hire to Tempus. Creates the employee, contract, and initial work-shift assignment in a single transaction.'
section: features
tags:
  - tempus
  - hr
  - onboarding
  - wizard
updated: '2026-06-17'
---

> The **employee onboarding wizard** is the guided form for adding a new hire to Tempus. It creates the [employee](tempus_employees.md), the [contract](tempus_contracts.md), and the initial [work-shift assignment](tempus_employee_work_shifts.md) in a single transaction.

## Overview

This is the recommended path for new hires. The standalone forms for the three entities also exist, but the wizard walks through every required field in order and produces a working employee record on save. It has three sections: employee details, contract details, and work-shift assignment.

## What it does

The first step either creates a new employee or attaches to an existing one (useful for records left without a contract by a migration or API import). The contract section uses the same fields as the standalone [Contracts](tempus_contracts.md) form.

The work-shift dropdown in section 3 is filtered by the weekly hours entered in section 2, so only shifts whose total matches appear.

On save, the wizard creates or updates the employee, the contract, and the work-shift assignment, then returns to the employee's edit page. If any step fails the entire transaction rolls back, so there is no partial onboarding. Once saved, the employee is active and can log in on day one if linked to a Voxbi account.

> [!WARNING]
> If no shifts appear after entering the weekly hours, no work shift matches that total. Create the matching shift in [Work shifts](tempus_work_shifts.md) first, or adjust the weekly hours.

## See also

- [Employees](tempus_employees.md), [Contracts](tempus_contracts.md), [Employee work shifts](tempus_employee_work_shifts.md) - the three entities the wizard creates.
- [Work shifts](tempus_work_shifts.md) - the templates the wizard picks from.
- [Companies](tempus_companies.md), [Departments](tempus_departments.md) - the org context.
- [Users (Cockpit)](../telephony/users.md) - the optional user-account link.