---
title: "Create User"
method: POST
path: "/api/users"
tags: ["Users"]
---

# Create User

`POST /api/users`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/users`
- Auth: HTTP bearer

POST /api/users

## Request body

- object
  - `email` string, email, required
  - `firstName` string
  - `lastName` string
  - `role` 'admin' | 'editor' | 'readonly' | 'responder', required
  - `customerIds` union[]
    - union
      - integer
      - string
  - `organizationId` integer
  - `language` 'de' | 'en' | 'da'

## Response `200`

OK

- object: Sends an invitation mail; the login sets its own password.
  - `success` true, required
  - `user` object, required
    - `id` string, required
    - `email` string, required
    - `name` string, nullable, required
    - `role` string, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)