---
title: "Create a new user"
method: POST
path: "/usermanagement/v1/users"
tags: ["User Management"]
---

# Create a new user

`POST /usermanagement/v1/users`

Creates a new user in Druva inSync with the settings defined in this API.

## Request body

- object — To create a user in Druva inSync.
  - `userName` string, required — Specify the username for the user in Druva inSync. Example - Ernie Carter
  - `profileID` integer, required — Specify the ID of the profile to be associated with the user account. Get the ID of a profile using the 'List all profiles' API.
  - `storageID` integer, required — Specify the ID of the storage on which the user data backed up by inSync should be stored. Get the ID of a storage using the 'List all storages' API.
  - `emailID` string, required — Specify the email address of the user.
  - `quota` integer — Specify the storage quota that should be allocated to the new user. Specify a value between 0 to 1023. Example - 1000 :fa-info-circle: If kept blank, the storage quota configured in the profile is assigned to the user.
  - `quotaUnit` 'MB' | 'GB' | 'TB' — Specify the storage unit for the quota value (MB,GB, OR TB).
  - `sendPasswordByEmail` boolean — Specify whether to send the password to the user by email. If false, password is not sent to the user. Default is true and password will be sent to the user's email address.

## Response `200`

OK

- UserCreate
  - `userID` integer — The unique id of the user in Druva inSync. Example - 1
  - `userName` string — The user name of the user in Druva inSync. Example - Ernie Carter
  - `emailID` string — The email address of the user. Example - ernie.carter@druva.com
  - `status` 'active' | 'preserved' — The status of the user account. Example - active
  - `profileID` integer — The profile ID of the profile associated with the user. Example - 1
  - `storageID` integer — The storage ID of the storage associated with the user. Example - 1
  - `quota` string — The storage quota assigned to the user in inSync. Example - 50 GB
  - `quotaInBytes` integer — The storage quota (in bytes) assigned to the user in inSync. Example - 53687091200
  - `addedOn` string, date-time — The date on which the user was added in inSync. Example - 2019-10-25T00:00:00Z

## Other responses

- `400` — Bad Request. Provide an appropriate value in the range of 0 to 1023 for User quota.
- `401` — The request did not include an authentication token or an expired authentication token was supplied.
- `404` — The requested resource was not found.
- `422` — The request was well-formed but was not processed due to semantic errors.
- `500` — The request was not processed due to an internal error in inSync GovCloud.
- `501` — Requested HTTP method is not implemented.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)