Skip to main content
App Users are programmatic user accounts that can be created by apps using server authentication ( or ). They represent users, groups, or processes behind the scenes in your application without requiring a Box account to log in. Before you can create App Users, your JWT or CCG application must be in the Admin Console, which generates a . You use the Service Account’s access token to create App Users through the API. App Users can only be accessed through the Box APIs and don’t have credentials to log in to box.com directly.

Common App User Patterns

Typically app users are created for a number of different patterns:
  • To represent a single application user or group of users without a box.com account.
  • To represent an application process, such as having the app user monitor all events within an enterprise.
  • To provide the application with the ability to completely control the file and folder structure of a user account without the possibility of that content being modified through the box.com web app.

Creating a New App User

To generate a new app user, the minimal information that will be required will be a name for the app user.
BoxUser.Info createdUserInfo = BoxUser.createAppUser(api, "A User");
To see all available optional parameters that may be set when creating an app user, see the .
Before you can make any changes to the newly created account, you need to click the link you receive in the confirmation email.
Once the app user is created a user object will be returned. Within the user object is an ID for the app user, which may be used to make API requests to modify the user in the future.