Create Managed User

Guides Users Create Managed User
Edit this page

Create Managed User

To generate a new managed user, the minimal information that will be required will be a name and an email address for the managed user.

The email address supplied when creating a managed user must be unique. It cannot already be associated with an existing Box user.

curl -i -X POST "" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "login": "",
       "name": "Aaron Levie"
var userParams = new BoxUserRequest()
    Name = "Example User",
    Login = ""
BoxUser newUser = await client.UsersManager.CreateEnterpriseUserAsync(userParams);
BoxUser.Info createdUserInfo = BoxUser.createEnterpriseUser(api, "", "A User");
new_user = client.create_user('Temp User', '')
	'Ned Stark',
		role: client.enterprise.userRoles.COADMIN,
		address: '555 Box Lane',
		status: client.enterprise.userStatuses.CANNOT_DELETE_OR_EDIT
	.then(user => {
		/* user -> {
			type: 'user',
			id: '44444',
			name: 'Ned Stark',
			login: '',
			created_at: '2012-11-15T16:34:28-08:00',
			modified_at: '2012-11-15T16:34:29-08:00',
			role: 'coadmin',
			language: 'en',
			timezone: 'America/Los_Angeles',
			space_amount: 5368709120,
			space_used: 0,
			max_upload_size: 2147483648,
			status: 'active',
			job_title: '',
			phone: '',
			address: '555 Box Lane',
			avatar_url: '' }
client.users.create(login: "", name: "New User") { (result: Result<User, BoxSDKError>) in
    guard case let .success(user) = result else {
        print("Error creating user")

    print("Created user \(, with login \(user.login)")
TypeScript Gen
await client.users.createUser({
  name: userName,
  isPlatformAccessOnly: true,
} satisfies CreateUserRequestBody);
Python Gen
client.users.create_user(user_name, is_platform_access_only=True)
.NET (Beta)
await client.Users.CreateUserAsync(requestBody: new CreateUserRequestBody(name: userName) { IsPlatformAccessOnly = true });

To see all available optional parameters that may be set when creating an app user, see the create user endpoint.

A user object will be returned from the create user request. Within the user object is an ID for the managed user, which may be used to make API requests to modify the user in the future.

Once a new managed user is created the email address used will receive an email from Box asking them to create a password for the account. The account will be in a pending state until that action has taken place.

For security reasons passwords cannot be supplied when creating a new managed user