Skip to Content
Uptimeify Docs
Users

Create User

Creates a new user in the organization.

POST /api/users

Request Body

{
  "email": "jane@deinkunde.com",
  "firstName": "Jane",
  "lastName": "Doe",
  "role": "editor", // "admin", "editor", "readonly" or "responder"
  "language": "en", // Optional: "de", "en" or "da"
  "customerIds": ["11111111-1111-4111-8111-111111111111", "22222222-2222-4222-8222-222222222222"] // Optional: Limit access to specific customers via public IDs
}

Notes:

  • customerIds accepts customer public IDs and legacy numeric IDs.
  • customerIds is only allowed for role: "readonly". Sending a non-empty customerIds with any other role returns 400 with data.code: "customerIdsReadonlyOnly" (it used to be ignored silently, which created an organization-wide user).
  • Public IDs are the preferred format for new integrations.
  • language is optional: the new user's starting language for the dashboard, e-mails and text messages (de, en or da). It also decides the language of the invitation e-mail. Omitted, the user gets the language of the one customer they are invited for (readonly with a single customer), otherwise the organization's language. The user can change it later in their profile. Any other value is rejected with 400.
  • There is no password field: the user receives an invitation e-mail and sets their own password.

Response

Returns the created user object. See Error Codes for error responses.

On this page