How to register your own Box OAuth app

Register an OAuth app with Box and connect it to Nango

This guide shows you how to register your own app with Box to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Box account.

1. Create a Box account

   If you don’t already have one, sign up for a free trial Box account.

2. Create a new application

   1. Go to the Box Developer Console.
   2. Click Create Platform App.
   3. Select Custom App as your Platform App from the list of application types.
   4. Enter the basic application details and choose User Authentication (OAuth 2.0) as your app’s Authentication Method.
   5. In your app’s Configuration tab, add https://api.nango.dev/oauth/callback as your Redirect URI, then click Save Changes.
   6. Scroll down to the Application Scopes section and select the scopes you need.
3. Obtain OAuth credentials

   1. In the same Configuration tab, under the OAuth 2.0 Credentials section, copy your Client ID and Client Secret, you’ll need these when configuring your integration in Nango.
4. Start building your integration

   Follow the Quickstart guide to build your integration.

Common Scopes

For a complete list of scopes, see Box’s scopes documentation.

Scope	Description
root_readwrite	Read and write access to all files and folders in the user’s account
root_readonly	Read-only access to all files and folders in the user’s account
manage_managed_users	Manage Managed Users (create, update, reset password, change roles)
manage_app_users	Manage App Users (for server-side JWT apps)
manage_groups	Create, update, delete groups, and manage group memberships
manage_webhook	Create and manage webhooks for a user

For more details on Box’s OAuth implementation, see Box’s OAuth documentation.

---