For the complete documentation index, see llms.txt. This page is also available as Markdown.

Import employees

Import or update employees via CSV file: columns, rules and typical errors.

Path: "My company" → "Company" → "Employees" → "Import"

There are two options:

  • "CSV import": a one-time import from a file (see below).

  • "HR sync": permanent, automatic synchronization with the HR system (see HR sync).

The CSV file

Download the sample file in the import dialog. First name, last name and user name (email) are required.

Column
Note

"First name", "Last name"

Required

"User name (email)"

Required; unique login name

Status

onboarding, active, leave or offboarding

"Location"

Name of the location; unknown locations are created

"Departments"

Unknown departments are created

"Position", "Personnel number", "Business phone", "Mobile no."

"Supervisor", "Representative"

Username, email or full name; the person must exist or be in the same file

"Cost center"

Cost center code (as under "Company profile" → "Cost center"); unknown codes are created. Also applies when updating existing employees.

"Note", "Private email address (optional)"

"Tags (comma-separated)"

Self-service tags

"Onboarding", "Offboarding"

Start and exit date

"Self-service active", "Send email invitation"

true, yes or 1

Home office address

Country (ISO-2 code), street, house number, postal code, city, state/province, address supplement, district; plus "Standard address"

"Further information"

Custom fields

Rules

  • Existing employees (same username) are updated. Location and status are not changed in the process. Use the bulk actions in the employee list for that.

  • Circular references between supervisors (A is supervisor of B and B of A) are detected and rejected.

  • A maximum of 2,500 invitation emails are sent per import.

  • Do not leave the page while the import is running.

Importing cost centers and billing addresses

You import cost centers and billing addresses under Settings → "Company profile"; see Cost centers and billing addresses.

Was this helpful?