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

# Box

## What's Supported

### Supported Actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://api.box.com`.

## Before You Get Started

To integrate Box with Ampersand, you will need [a Box Account](https://account.box.com/signup/).

Once your account is created, you'll need to create an app in Box, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

* Client ID
* Client Secret

You will then use these credentials to connect your application to Ampersand.

### Create a Box Account

Here's how you can sign up for a Box account:

* Go to the [Box Sign Up page](https://account.box.com/signup/).
* Sign up using your preferred method.

### Creating a Box App

Follow the steps below to create a Box app and add the Ampersand redirect URL.

1. Log in to your [Box](https://account.box.com/login) account.

2. Navigate to the [Box Developer Console](https://app.box.com/developers/console).

3. Click **Create New App** to create a new app.

4. Select the **Custom type** in the app type section.

5. Enter **App Name**.

6. Select a purpose for the app.

7. Click **Next**.

8. In the **Authentication Method** panel, select **User Authentication (OAuth 2.0)**.

9. Click **Create App**.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/3d26068-box1.gif?s=71292e2717caa2763ceac535f2f35e46" alt="Alt text" width="1440" height="678" data-path="images/provider-guides/3d26068-box1.gif" />

The **OAuth 2.0 Credentials** section displays **Client ID** and **Client Secret** keys for your app. You'll use these credentials to connect your app to [Ampersand](https://docs.withampersand.com/docs/box#add-your-box-app-info-to-ampersand).

### Configure Your App

1. From the more options next to your app and select **Configure App**.
2. In the **OAuth 2.0 Redirect URIs** section, enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`.
3. Click **Add**.
4. Select applicable scopes for your app.

<img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/57a8db3-box2.gif?s=35a5fa2e845a09855a1166310f82f787" alt="Alt text" width="1440" height="678" data-path="images/provider-guides/57a8db3-box2.gif" />

## Add Your Box App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Box integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Alt text" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider Apps**.

4. Select *Box* from the **Provider** list.

5. Enter the previously obtained *Client ID* in the **Client ID** field and the *Client Secret* in the **Client Secret** field.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/i4a56x-Fmj6u7jdE/images/provider-guides/c5dcec5-box3.gif?s=aee934770c2153cbe407a13e239817bd" alt="Alt text" width="768" height="484" data-path="images/provider-guides/c5dcec5-box3.gif" />

6. Click **Save Changes**.
