# Box

## Create a Box App

Since Teleskope follows a single-tenant architecture, each customer will have their own dedicated Teleskope instance, with a custom callback URL.

### Requirements

* You are subscribed to the *Enterprise* Box plan
* You are a Box Admin or Co-Admin

### Create a new app in Box

1. Go to the [Box Developer Console](https://developer.box.com/)
2. Create a new **Custom App:**
   1. Authentication method: Server Authentication (Client Credentials Grant)
3. Navigate to **Configuration:**
   1. Set **App Access Level** to **App + Enterprise Access**
   2. Enable the following **Application Scopes:**
      1. Read all files and folders stored in Box
      2. Read and write all files and folders stored in Box
      3. Manage enterprise properties
      4. Admin can make calls on behalf of User
      5. Manage app users
      6. Manage users
      7. Generate user access tokens
   3. Enable the following **Advanced Features:**
      1. Make API calls using the as-user header
4. Create a ticket with [**Box Support**](https://support.box.com/hc/en-us) to add the **Global Content Manager** role. You may need to provide justification or confirm the request as this scope allows broad access to your Box content.
5. Navigate to **Authorization** and select `Review and Submit`.
6. In the [Box Admin Console](https://app.box.com/master/platform-apps), authorize your app for enterprise access (requires view/edit settings and integrations for your company permissions).
7. Configure [Client Credentials Grant](https://developer.box.com/guides/authentication/client-credentials/) in Box.
8. Enter your Box credentials in the Teleskope UI.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.teleskope.ai/connectors/saas/box.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
