---
title: "create a new user"
method: POST
path: "/Users"
tags: ["Users"]
---

# create a new user

`POST /Users`

## Request body

- object
  - `name` string, required — username
  - `email` string, required — user email address
  - `is_active` boolean, required — user account is active
  - `force_change` boolean, required — require the user to change password on next login
  - `initial_password` string, required — users password
  - `account_sid` string, uuid — account sid the account the user will have access to, if not set will create a Service Provider account
  - `service_provider_sid` string, uuid — The service provider sid, the account is under, if not set account will be admin level
  - `is_view_only` boolean, required — if set to true the user will not be able to make changes

## Response `200`

user created

- object
  - `user_sid` string, uuid — The sid of the newly created user

## Other responses

- `403` — user creation failed
- `500` — system error

## Changes

- **2025-07-22** `48a23aab79d1` — 7 breaking, 3 warning, 3 info
  - added the new required request property `initial_password`
  - added the new required request property `is_view_only`
  - the request property `email` became required
  - the request property `force_change` became required
  - …9 more
- **2025-05-19** `321f4216d437` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/jambonz/apis/jambonz-api/changes/Users/post.md)

---

[API](https://skmtc.dev/jambonz/apis/jambonz-api.md) · [All operations](https://skmtc.dev/jambonz/apis/jambonz-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jambonz/jambonz-api/revisions/56f317145d23/schema)