Skip to main content
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 "https://api.box.com/2.0/users" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "login": "[email protected]",
       "name": "Aaron Levie"
     }'
To see all available optional parameters that may be set when creating an app user, see the create user endpoint.
Before you can make any changes to the newly created account, you need to click the link you receive in the confirmation email.
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