---
title: "Changes to Create new user"
method: POST
path: "/users"
---

# Changes to Create new user

`POST /users`

> Every recorded change to this operation, newest first.
> 30 revisions in range; 1 not diffed.

## Timeline

Changed in 2 of 30 revisions.

- **2026-10-14** `2b88e9e9811f`: 1 info
- **2026-08-08** `222e6fad7c1f`: 1 breaking, 10 info

## Changes

- **2026-10-14** `2b88e9e9811f`: 1 info
  - added the new `VIEW_ONLY` enum value to the request property `role`
- **2026-08-08** `222e6fad7c1f`: 1 breaking, 10 info
  - removed the media type `application/octet-stream` from the request body
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `query` request parameter `skipWebhook`
  - added the new optional request property `authType`
  - added the new optional request property `customRole`
  - added the new optional request property `extraFields`
  - added the new optional request property `hourlyRate`
  - added the new `OPERATOR` enum value to the request property `role`
  - added the new `SERVICE_ACCOUNT` enum value to the request property `role`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`

---

[Operation](https://skmtc.dev/getmaintainx/apis/maintainx-api/docs/users/post.md) - [API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [Page](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/users/post)