---
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

---

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