> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://www.box.com/pricing).

**2. Create a new application**

1. Go to the [Box Developer Console](https://app.box.com/developers/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](https://nango.dev/docs/getting-started/quickstart.md) guide to build your integration.

## Common Scopes

For a complete list of scopes, see [Box's scopes documentation](https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/).

| 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](https://developer.box.com/guides/authentication/oauth2/).

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.