Nutzer per CSV importieren

Mit dem CSV-Import kannst du Nutzer in großer Zahl einladen und optional direkt Teams zuweisen.

Wenn du Nutzer zu Teams zuweisen möchtest, die noch nicht existieren, erstelle sie zuerst mit dem Team-CSV-Import und komm dann hierher zurück.

Wo du ihn findest

Gehe zu Nutzer und klicke auf Nutzer importieren.

CSV-Format

Deine CSV-Datei braucht mindestens eine email-Spalte. Alle anderen Spalten sind optional:

Spalte	Beschreibung	Beispiel
email	E-Mail-Adresse (erforderlich)	`jane@example.com`
firstName	Vorname	`Jane`
lastName	Nachname	`Smith`
title	Berufsbezeichnung	`Account Executive`
phone	Telefonnummer	`+49 170 1234567`
timezone	Zeitzone	`Europe/Berlin`
language	Sprachcode	`de`
isAdmin	Firmen-Admin (true/false)	`true`
teamName	Zuzuweisendes Team	`Vertrieb DACH`
teamRole	Rolle im Team (admin/user)	`user`

Neue Nutzer werden automatisch per E-Mail eingeladen. Sie erhalten einen Einladungslink und können ihr Passwort beim ersten Login festlegen. Sie sind sofort für Buchungen verfügbar – auch bevor sie die Einladung annehmen.

Bestehende Nutzer (gleiche E-Mail in deiner Organisation) werden erkannt und nicht erneut eingeladen. Sie können aber im gleichen Import einem Team zugewiesen werden.

Team-Zuweisung passiert im selben Schritt. Wenn du einen teamName angibst, wird der Nutzer mit der angegebenen Rolle zum Team hinzugefügt (Standard ist user, wenn keine Rolle angegeben ist).

Sonderfälle und Lösungen

Situation	Was passiert	Was du tun kannst
Nutzer existiert bereits in deiner Organisation	Wird als „existierend" gezählt, nicht erneut eingeladen. Team-Zuweisung funktioniert trotzdem.	Nichts nötig – das ist normal.
E-Mail existiert in einer anderen Organisation	Fehler für diese Zeile: „Konto existiert bereits in einer anderen Organisation"	Der Nutzer muss zuerst aus der anderen Organisation entfernt werden, oder verwende eine andere E-Mail.
Teamname nicht gefunden	Fehler für diese Zeile: „Team nicht gefunden"	Führe zuerst den Team-Import durch, dann importiere die Nutzer erneut.
Gleiche E-Mail erscheint zweimal in der CSV	Erste Zeile lädt den Nutzer ein, zweite Zeile macht nur die Team-Zuweisung.	Das ist in Ordnung – nützlich, um einen Nutzer mehreren Teams zuzuweisen.
Ungültiges E-Mail-Format	Wird vor dem Import in der Vorschau erkannt. Zeile wird rot markiert und ausgeschlossen.	Korrigiere die E-Mail in deiner CSV und lade sie neu hoch.
Ungültige Team-Rolle	Wird vor dem Import erkannt. Muss `admin` oder `user` sein.	Korrigiere den Wert in deiner CSV.

Nach dem Import

Du siehst eine Zusammenfassung mit:

Wie viele Nutzer eingeladen wurden (neue Konten)
Wie viele Nutzer bereits existierten
Wie viele Nutzer Teams zugewiesen wurden
Eventuelle Fehler mit E-Mail und Grund pro Zeile
Einladungslinks für neu eingeladene Nutzer (mit Kopier-Button)

Spaltenerkennung

Der Import erkennt Spalten automatisch anhand gängiger Überschriften auf Deutsch und Englisch (z.B. Vorname → Vorname, Nachname → Nachname, E-Mail → E-Mail-Adresse). Wenn die automatische Erkennung nicht passt, klicke auf Spalten zuordnen, um die Zuordnung manuell anzupassen.

Limits

Maximal 500 Zeilen pro Upload
Rate-Limit: 3 Importe pro Minute

Der CSV-Import steht Organisationen mit aktivierter Teams-Funktion (Workspaces) zur Verfügung. Nur Firmen-Administratoren können Importe durchführen.