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

# Dropbox

## How it works

The Dropbox connector imports all documents from your Dropbox account into ASSIST AI.

It recursively retrieves all files starting from the root directory of your account - at this time, it is not possible to limit imports to specific folders only. The connector performs a single pull upon initialization.

To bring in additional documents later, you'll need to generate a new access token (see Step 4 below), enter it into the connector, and re-initialize it.

## Setting Up

### Authorization

1. **Create a Dropbox App** — Go to [https://www.dropbox.com/developers/apps](https://www.dropbox.com/developers/apps) and click `Create app` in the top-right corner. Select `Scoped access` and `Full Dropbox` as the access type. Give your app a name such as "ASSIST AI Connector" and click `Create app`.
   <Frame>
     <img src="https://mintcdn.com/ac-b0a71323/VCc_sygWeGeUuy6m/images/d1.png?fit=max&auto=format&n=VCc_sygWeGeUuy6m&q=85&s=2ddfc99d19adaa634195ad8bb706e349" alt="D1" width="1920" height="1032" data-path="images/d1.png" />
   </Frame>
2. **Open Permissions** Click on the `Permissions` tab.
   <Frame>
     <img src="https://mintcdn.com/ac-b0a71323/VCc_sygWeGeUuy6m/images/2.png?fit=max&auto=format&n=VCc_sygWeGeUuy6m&q=85&s=bdd2385964046979aa89637799bed2ef" alt="2" width="504" height="147" data-path="images/2.png" />
   </Frame>
3. **Grant Required Scopes** Enable the `files.content.read` and `sharing.write` permissions so that files can be read and document links can be generated. Click `Submit `to save your changes.
   <Frame>
     <img src="https://mintcdn.com/ac-b0a71323/VCc_sygWeGeUuy6m/images/3.png?fit=max&auto=format&n=VCc_sygWeGeUuy6m&q=85&s=4529a3d42f81d2bf0714db007448c750" alt="3" width="1920" height="1032" data-path="images/3.png" />
   </Frame>
4. **Generate an Access Token** Go to the `Settings `tab and scroll down to the `OAuth 2`section. Click `Generate` to create an access token.

<Warning>
  Permissions must be granted before generating an access token. Updating permissions after the fact will not apply to existing tokens, and ASSIST AI will be unable to index your Dropbox content.
</Warning>

5. **Copy the Access Token** Copy the generated token and store it for the next step. Refresh the page if you need to regenerate the token.
   <Frame>
     <img src="https://mintcdn.com/ac-b0a71323/VCc_sygWeGeUuy6m/images/4.png?fit=max&auto=format&n=VCc_sygWeGeUuy6m&q=85&s=0af478edc917f0b812f933b06687bed7" alt="4" width="209" height="94" data-path="images/4.png" />
   </Frame>

## Indexing

1. **Open the Dropbox Connector** In the ASSIST AI interface, navigate to the Admin Panel and select the Dropbox Connector.
2. **Enter the Access Token** Paste the access token you copied in the previous step.
3. **Start Indexing** Click "Connect" to begin importing your Dropbox files into ASSIST AI.