# How to Create OAuth Credentials for Box

This guide will help you set up your Box OAuth app to connect with Apideck.

To create a connection with Box, you need to complete the following steps:

1. [Create OAuth App in Box](#1-create-oauth-app-in-box)
2. [Configure connector in Apideck](#2-configure-connector-in-apideck)

## 1. Create OAuth App in Box

### Login to Box Developer Console

- Go to [https://app.box.com/](https://app.box.com/) and log in to your Box account
- Navigate to the **Developer Console** at [https://app.box.com/developers/console](https://app.box.com/developers/console)

![Box Developer Console](https://res.cloudinary.com/apideck/image/upload/v1761146793/docs/connectors/box/box-dev-console.png)

### Create Platform App

- Click **Create Platform App** to start creating your application

![Box Create Platform App](https://res.cloudinary.com/apideck/image/upload/v1761145873/docs/connectors/box/dev-console.png)

### Choose Custom App

- Select **Custom App** as the app type

![Box Choose Custom App](https://res.cloudinary.com/apideck/image/upload/v1761145874/docs/connectors/box/create-custom-app.png)

### Configure App Details

Fill out the basic information for your app:

- **App Name**: Enter a descriptive name (e.g., "Apideck")
- **Description**: Provide a brief description of your integration

![Box App Configuration Step 1](https://res.cloudinary.com/apideck/image/upload/v1761145873/docs/connectors/box/create-custom-app-step1.png)

- **Purpose**: Select "Integration"
- **Category**: Select "Workflow"
- **External System**: Add "Apideck" to "Which external system are you integrating with?"
- **Who is building this application?**: This field is optional

![Box App Configuration Step 2](https://res.cloudinary.com/apideck/image/upload/v1761145876/docs/connectors/box/create-custom-app-step2.png)

### Configure Authentication

- Select **OAuth 2.0** as the authentication method
- Click **Create app**

![Box OAuth 2 Configuration](https://res.cloudinary.com/apideck/image/upload/v1761145873/docs/connectors/box/create-custom-app-step3.png)

### Copy OAuth 2 Credentials

After creating your app, scroll down to the **OAuth 2.0 credentials** section and copy the following credentials:

- **Client ID**
- **Client Secret**

**⚠️ Important**: Store these credentials securely as you'll need them for the next step.

![Box OAuth 2 Credentials](https://res.cloudinary.com/apideck/image/upload/v1761146095/docs/connectors/box/oauth-credentials.png)

### Configure Redirect URI

- Under **OAuth 2.0 Redirect URIs**, add the following redirect URI:
  ```
  https://unify.apideck.com/vault/callback
  ```

![Box Redirect URI Configuration](https://res.cloudinary.com/apideck/image/upload/v1761145874/docs/connectors/box/redirct-uri.png)

### Set Application Scopes

- Under **Application Scopes**, select the appropriate permissions for your integration:
  - **Read only**: Select the first option for read-only access
  - **Read and Write**: Select both options for full access
- Click **Save changes**

![Box Application Scopes](https://res.cloudinary.com/apideck/image/upload/v1761145874/docs/connectors/box/app-scopes.png)

## 2. Configure connector in Apideck

Now that you've successfully created your Box OAuth app, you can add the credentials in the configuration of the connector.

### Add Credentials

- Go to your Apideck dashboard at [https://platform.apideck.com/](https://platform.apideck.com/)
- Navigate to **Configuration > Box**
- Enter the following credentials:
  - **Client ID**: The Client ID you copied from Box
  - **Client Secret**: The Client Secret you copied from Box
- Select the same scopes you enabled in Box previously
- Click **Save**

![Box Connector Configuration](https://res.cloudinary.com/apideck/image/upload/v1761145874/docs/connectors/box/connector-config.png)

### Test the Connection

You can test your Box connector by clicking **Test Vault**

![Box Test Vault](https://res.cloudinary.com/apideck/image/upload/v1761145874/docs/connectors/box/test-vault.png)

- Click **Authorize** to start the OAuth flow

![Box Authorize Connection](https://res.cloudinary.com/apideck/image/upload/v1761145874/docs/connectors/box/authorize-connection.png)

- Grant the requested permissions in the Box authorization dialog

![Box Grant Access](https://res.cloudinary.com/apideck/image/upload/v1761145875/docs/connectors/box/give-consent.png)

- Your connection should now show as **Connected**

![Box Connection Status](https://res.cloudinary.com/apideck/image/upload/v1761145875/docs/connectors/box/status-connected.png)