Skip to main content
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.
ScopeDescription
root_readwriteRead and write access to all files and folders in the user’s account
root_readonlyRead-only access to all files and folders in the user’s account
manage_managed_usersManage Managed Users (create, update, reset password, change roles)
manage_app_usersManage App Users (for server-side JWT apps)
manage_groupsCreate, update, delete groups, and manage group memberships
manage_webhookCreate and manage webhooks for a user
For more details on Box’s OAuth implementation, see Box’s OAuth documentation.