Skip to Content
Uptimeify Docs

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:

  • customerIds akzeptiert Customer-Public-IDs und weiterhin Legacy-Integer-IDs.
  • customerIds ist nur bei role: "readonly" erlaubt. Eine nicht leere customerIds-Liste mit einer anderen Rolle ergibt 400 mit data.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.
  • language ist optional: die Startsprache des neuen Benutzers für Dashboard, E-Mails und SMS (de, en oder da). Sie bestimmt auch die Sprache der Einladungsmail. Ohne Angabe gilt die Sprache des einen Kunden, für den er eingeladen wird (readonly mit genau einem Kunden), sonst die der Organisation. Der Benutzer kann sie später im Profil ändern. Jeder andere Wert wird mit 400 abgelehnt.
  • 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.

Auf dieser Seite