How to register your own Box OAuth app
Register an OAuth app with Box and connect it to Tenklo
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.
If you don't already have one, sign up for a free trial Box account.
- Go to the Box Developer Console.
- Click Create Platform App.
- Select Custom App as your Platform App from the list of application types.
- Enter the basic application details and choose User Authentication (OAuth 2.0) as your app's Authentication Method.
- In your app's Configuration tab, add
https://api.tenklo.dev/oauth/callbackas your Redirect URI, then click Save Changes. - Scroll down to the Application Scopes section and select the scopes you need.
- 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 Tenklo.
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.