Benutzer erstellen
Erstellt einen neuen Benutzer in der Organisation.
POST /api/users
Anfrage (Request Body)
{
"email": "jane@deinkunde.com",
"firstName": "Jane",
"lastName": "Doe",
"role": "editor", // "admin", "editor", "readonly" oder "responder"
"language": "en", // Optional: "de", "en" oder "da"
"customerIds": ["11111111-1111-4111-8111-111111111111", "22222222-2222-4222-8222-222222222222"] // Optional: Zugriff auf bestimmte Kunden per Public ID beschränken
}Hinweise:
customerIdsakzeptiert Customer-Public-IDs und weiterhin Legacy-Integer-IDs.customerIdsist nur beirole: "readonly"erlaubt. Eine nicht leerecustomerIds-Liste mit einer anderen Rolle ergibt400mitdata.code: "customerIdsReadonlyOnly"(früher wurde sie still ignoriert, und der Nutzer bekam Zugriff auf die ganze Organisation).- Für neue Integrationen sind Public IDs die bevorzugte Form.
languageist optional: die Startsprache des neuen Benutzers für Dashboard, E-Mails und SMS (de,enoderda). Sie bestimmt auch die Sprache der Einladungsmail. Ohne Angabe gilt die Sprache des einen Kunden, für den er eingeladen wird (readonlymit genau einem Kunden), sonst die der Organisation. Der Benutzer kann sie später im Profil ändern. Jeder andere Wert wird mit400abgelehnt.- Es gibt kein Passwortfeld: der Benutzer erhält eine Einladungsmail und setzt sein Passwort selbst.
Antwort (Response)
Gibt das erstellte Benutzerobjekt zurück. Siehe Fehlerliste für Fehlerantworten.