---
title: "Box"
slug: "box"
updated: 2025-03-27T15:58:41Z
published: 2025-03-27T15:58:41Z
canonical: "docs.databee.buzz/box"
---

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

# Box

Box is a cloud content management platform designed to help businesses manage and collaborate on files securely. It provides solutions for file storage, sharing, and collaboration, allowing users to access their content from anywhere while ensuring data security. For detailed information refer to the [Box’s official documentation](https://developer.box.com/guides/).

**Integration Method:** API

**Tables**: Authentication (3002), Detection Finding (2004), File Hosting Activity (6006)

This integration supports the following events.

| **Event** | **Description** |
| --- | --- |
| Events | Retrieves events for a given user or for the entire enterprise. |

This integration supports the following versions.

| Box Version Supported | 2.0 |
| --- | --- |
| Box API version Supported | 2.0 |

> [!NOTE]
> **Note:**
> 
> As of this document preparation, latest release was on [Sept 27, 2024](https://support.box.com/hc/en-us/articles/33830992465683-Box-Drive-v2-41-Release-Notes).

## Prerequisites

- Access to the Box platform to generate API credentials.
- Access to the DataBee console.

## Configuration Overview

1. Create an API Client and obtain the required authentication details, including the **Client ID** and **Client Secret.**
  1. [Create Platform App](/user-manual/docs/box#create-platform-app).
  2. [Authorize APP](/user-manual/docs/box#authorize-app).
2. Create [Box Data Feed](/user-manual/docs/box#databee-configuration) in the DataBee console with the required API credentials.

| **DataBee Parameter** | **Box Parameter** |
| --- | --- |
| Client ID | API Client ID |
| Client Secret | API Client Secret |

## Box Configuration

### Create Platform App

1. Before creating the app, make sure that 2FA (two-factor authentication) is enabled.
  1. Go to [Box Account Settings](https://app.box.com/account/developer). ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-h009e1sm.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
  2. Select type of sign-in method as ‘Authentication App’ and click **Next.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-w763z6yl.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
  3. Configure 2-Step Verification and click **submit.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-h7aho3nn.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
2. Login to [Box Dev Consol](https://app.box.com/developers/console).
3. Click on **Create Platform App.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-aabpbcfe.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
4. From Box Developer Console, Select **Custom App.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-7ntcpmlr.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
  1. Enter an App Name and provide a description. Select Purpose and Categories according to your requirement. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-eodve1id.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
  2. Select authorization method “Server Authentication (Client Credentials Grant)”.
  3. Click on C**reate** **App** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-iw7b0vij.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
5. Copy the **Client ID** for later use. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-m8wt9ls8.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
6. Click on **Fetch Client Secret** and complete **2FA.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-epc8u0oy.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
7. Click again on Fetch Client Secret and copy **Client Secret**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-6rtmrovu.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
8. Change the app access level to **App + Enterprise Access**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-xoxlmx40.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
9. In Application scope, select all Administrative Actions checkbox and then click on **Save Changes**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-x71r7wtk.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)

> [!NOTE]
> Note:
> 
> You will not be able to view client secrets again after you complete this step. Ensure that you copy it before closing it.

**Reference**: [**Reference Events**](https://developer.box.com/reference/get-events/)**.**

### Authorize APP

1. Login to [Admin Console](https://app.box.com/master/admin) after building the App from Developer Console to authorize that app.
2. From Box Admin Console, Navigate to **Integrations.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-vtbirgzv.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
3. Navigate to **Platform Apps Manager** and click on **Add Platform App** button.
4. Add Client Id which you have copied from the previous step and click on **Next.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-uwvmslzt.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
5. Click on **Authorize.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-unns9v7h.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
6. In the Admin console navigate to **Account & Billing** and save E**nterprise ID**. This is also known as **Box Subject ID** also which will be required while configuring the DataBee integration. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-8s6lll6k.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)

## DataBee Configuration

1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-ufptv364.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)

1. Search for the **Box** and click it as shown below**.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-ta2138p1.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
2. Click on the **API Ingest** option for the collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-9bxqzmj0.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
3. Enter feed contact information and click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-lb4culma.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
4. In the endpoint configuration page, fill in the following:

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/box-mar2025-image-sf7ohio8.png?sv=2026-02-06&spr=https&st=2026-10-28T23%3A20%3A31Z&se=2026-10-29T00%3A20%3A31Z&sr=c&sp=r&sig=qM210PJ%2FLGr4ufdqHUZWtEcpZR26D8FvMfbi%2FVQF12k%3D)
  1. Authorization Method: OAuth2
  2. API Base URL: this is the base URL that DataBee will interact with.
  3. Client Key: paste the **Client Id**.
  4. Client Secret: paste the **Client Secret**.
  5. Box Subject Id: paste the **Enterprise Id**.
  6. Token URL: [Token URL](https://api.box.com/oauth2/token).
5. Click **Submit**.

## Troubleshooting Tips

- Ensure the Client ID and Client Secret are entered correctly. Since you cannot view the secret after the first time, store it securely in a text editor to verify there are no spaces or unexpected characters before configuring the DataBee integration.
- Verify that the required Box API scopes/permissions are correctly configured.
- Ensure you are using Box API version 2.0, as this integration has been tested against it.