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.
"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?