--- title: "Dropbox" slug: "dropbox" updated: 2025-03-21T02:37:09Z published: 2025-03-21T02:37:09Z canonical: "docs.databee.buzz/dropbox" --- > ## 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. # Dropbox Dropbox is a cloud storage service that allows users to store files online and access them from any device with an internet connection. For detailed information, please refer to the [Dropbox’s official documentation](https://www.dropbox.com/official-teams-page?_tk=paid_sem_goog_biz_b&_camp=1018334849&_kw=dropbox|e&_ad=666300362351||c&gad_source=1&gclid=Cj0KCQjw4cS-BhDGARIsABg4_J2wPDR09061PIjChcX3bTJ071KEe3NtoSgqoLG3qHBSYPSPpGdzNxIaAowbEALw_wcB). **Integration Method:** API **Tables**: Detection Finding (2004), User Inventory (5003), File Hosting Activity (6006), Authentication (3002) This integration supports the following events. | **Event** | **Description** | | --- | --- | | Members | Retrieves the lists of members of a team. | | Team Events | Retrieves team events. | This integration supports the following versions. | Dropbox Version | Business Plan | | --- | --- | | Dropbox API version | v2 | ## Prerequisites - The user should have **Dropbox Business plan** to get Members and Team events. - The app which we create for OAuth credential should have **team_data.member**, **members.read**, **events.read** permissions to get Members and Team events. - The user should have access to the DataBee console. ## Configuration Overview 1. Create an **App** in the [App console](https://www.dropbox.com/developers/apps) with the required permissions. 2. Add the [Dropbox data feed](/user-manual/docs/dropbox#databee-configuration) in the DataBee console with the below parameters. | **DataBee Parameter** | **Dropbox Parameter** | | --- | --- | | Client Key | App key | | Client Secret | App secret | | Authorization Code | Access code | ## Dropbox Configuration ### Register an app in Dropbox app console To get access to Dropbox API first we need to create an App. To create an app, follow the steps below. 1. Access the [Dropbox app console](https://www.dropbox.com/developers/apps). On the log in page enter your Dropbox log in credentials. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-dt070863.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 2. Click on **Create app.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-4zvkphb6.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 3. Select the configuration below while creating the app. - Choose an API: Scoped access New - Choose the type of access you need: Full Dropbox - Name your app: enter the Unique name of your app. 4. Click on **Create app.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-7o5w6dik.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) ### Add permissions to app We require enough permissions to get Members and Team event data. To add permissions to app, follow the below steps. 1. Once app is created, click on **Permissions** tab shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-4ygjswcf.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 2. Select the below required permissions and click on **Submit** button. - team_data.member - members.read - events.read ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-xs259fjq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-zyyjvrgb.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) ### Get App key and App secret 1. Click on **Settings** tab. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-6g73hnzb.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 2. Store the **App key** and click **Show** to reveal the **App secret**. Save both for later use during DataBee configuration and when generating the Authorization code. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-8q7o2il3.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-xhqq87xk.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) ### Generate Access Code 1. Access the [Dropbox OAuth Authorize Page](https://www.dropbox.com/oauth2/authorize?client_id=bpclzq273luqjoy&response_type=code&token_access_type=offline). Replace with the **App key** obtained in the previous step, then click **Continue**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-epug5uap.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 2. Click on **Allow**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-v504355j.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 3. After clicking on allow we will get the **Access code** that we need to add during DataBee configuration. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-wsano7sy.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%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/dropbox-doc-standard-image-9jkfejp2.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 2. Search for the **Dropbox** and click it as shown below ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-gj2ldved.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-sdlaoxnc.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 4. Enter feed contact information and click **Next.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-t1d5mk8k.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) 5. In the configuration page, confirm the following: ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dropbox-doc-standard-image-r2m4ofvg.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A57%3A20Z&se=2026-10-30T13%3A57%3A20Z&sr=c&sp=r&sig=IurwjTau4J8DHMPfGGXira1FQc9qM8skjkVTKYA0sus%3D) - Authorization Method: OAuth2 - API Base URL: this is the base URL that DataBee will interact with. - Client Key: paste the App key obtained in the Dropbox app console. - Client Secret: paste the App secret obtained in the Dropbox app console. - Authorization Code: paste the Access Code which we have generated previously. - Token URL: this is the token URL which will be used to generate tokens. - Event Types: preselected for all the event types that integration pulls. 6. Click **Submit**. ## Troubleshooting Tips - If you are facing **an invalid grant** or **code has already been used** error this might be possibly due to Access code having been used multiple times. In that case generate a new authorization code and reconfigure the DataBee feed. Ensure the client key, client secret are pasted correctly. - If you are facing **400** response codes with error **Your app is not permitted to access this endpoint** this might be possibly due to missing permissions. Ensure that all the required permissions to the app are granted correctly as per the above-mentioned steps.