Importing users via CSV

You can use CSV import to bulk-invite users to your organization and optionally assign them to teams in the same step.

If you want to assign users to teams that don't exist yet, create them first with the Team CSV Import, then come back here.

Where to find it

Go to Users and click the Import Users button.

CSV format

Your CSV needs at least an email column. All other columns are optional:

Column	Description	Example
email	Email address (required)	`jane@example.com`
firstName	First name	`Jane`
lastName	Last name	`Smith`
title	Job title	`Account Executive`
phone	Phone number	`+49 170 1234567`
timezone	Timezone	`Europe/Berlin`
language	Language code	`de`
isAdmin	Company admin (true/false)	`true`
teamName	Team to assign to	`Sales DACH`
teamRole	Role in team (admin/user)	`user`

New users are automatically invited via email. They receive an invitation link and can set up their password when they first log in. They are available for bookings immediately — even before accepting the invite.

Existing users (same email in your organization) are recognized and not re-invited. They can still be assigned to a team in the same import.

Team assignment happens in the same step. If you specify a teamName, the user is added to that team with the role you specify (defaults to user if no role given).

Edge cases and how to handle them

Situation	What happens	What to do
User already exists in your organization	Counted as "existing", not re-invited. Team assignment still works.	Nothing needed — this is expected.
Email exists in another organization	Error for that row: "Account already exists in another organization"	The user must be removed from the other organization first, or use a different email.
Team name not found	Error for that row: "Team not found"	Run Team Import first to create the team, then re-import the user rows.
Same email appears twice in CSV	First row invites the user, second row only does team assignment.	This is fine — useful for assigning one user to multiple teams.
Invalid email format	Caught before import in the preview step. Row is marked red and excluded.	Fix the email in your CSV and re-upload.
Invalid team role	Caught before import. Must be `admin` or `user`.	Fix the role value in your CSV.

After import

You see a summary with:

How many users were invited (new accounts)
How many users already existed
How many users were assigned to teams
Any errors with the email and reason per row
Invite links for newly invited users (with copy buttons)

Column matching

The import auto-detects columns by common header names in English and German (e.g. Vorname → First Name, Nachname → Last Name, E-Mail → Email). If auto-detection doesn't match correctly, click Match Your Columns to manually assign CSV columns to the right fields.

Limits

Max 500 rows per upload
Rate limit: 3 imports per minute

CSV import is available for organizations with the Teams (Workspaces) feature enabled. Only company administrators can perform imports.