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

# Dropbox

> Access knowledge from Dropbox

## How it works

The Dropbox connector ingests all documents from your Dropbox account into Onyx.

The connector recursively pulls all files from the root directory of your Dropbox account.
It is currently not possible to pull files only from specific directories.

The connector will only pull once upon initialization. If you would like to pull more documents,
you must generate a new access token (step 6 below), put that token into the connector, and re-initialize the connector.

## Setting up

### Authorization

<Steps>
  <Step title="Create Dropbox app">
    Head over to [https://www.dropbox.com/developers/apps](https://www.dropbox.com/developers/apps) and click the `Create app` button on the top right.
    Select `Scoped access` and `Full Dropbox` as the type of access.
    Give your app a name like 'Onyx Connector' and click `Create app`.

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/dropbox/dropbox-connector-1.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=210fdc73117f8eee7d0b08d44665ddf3" alt="DropboxStep1" width="1898" height="1822" data-path="assets/admins/connectors/dropbox/dropbox-connector-1.png" />
  </Step>

  <Step title="Open Permissions">
    Click on the `Permissions` tab.

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/dropbox/dropbox-connector-2.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=439642edad50e9297072eb22904bcc44" alt="DropboxStep2" width="956" height="270" data-path="assets/admins/connectors/dropbox/dropbox-connector-2.png" />
  </Step>

  <Step title="Grant required scopes">
    Check the `files.content.read` and `sharing.write` permissions so the files can be read and links for the documents
    can be created. Click `Submit` to save the changes.

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/dropbox/dropbox-connector-3.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=a14d249f43af52e5327063c4fd2fd34d" alt="DropboxStep3" width="1166" height="1062" data-path="assets/admins/connectors/dropbox/dropbox-connector-3.png" />
  </Step>

  <Step title="Generate access token">
    Navigate to the `Settings` tab and scroll down to the `OAuth 2` section.
    Click `Generate` to generate an access token.

    <Warning>
      You must complete granting permissions before generating an access token.
      Changing permissions will not affect existing access tokens, and Onyx will be unable to index your Dropbox.
    </Warning>

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/dropbox/dropbox-connector-4.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=032a0e811ed193e0e332120293736a03" alt="DropboxStep4" width="1532" height="230" data-path="assets/admins/connectors/dropbox/dropbox-connector-4.png" />
  </Step>

  <Step title="Copy access token">
    Copy the access token.

    <Info>
      Refresh the page if you need to regenerate your access token
    </Info>

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/dropbox/dropbox-connector-5.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=49b122d9b7246c325dca8365d2d71103" alt="DropboxStep5" width="512" height="236" data-path="assets/admins/connectors/dropbox/dropbox-connector-5.png" />
  </Step>
</Steps>

### Indexing

<Steps>
  <Step title="Open Dropbox connector">
    In the Onyx UI, navigate to the Admin Panel and select the **Dropbox** Connector
  </Step>

  <Step title="Enter access token">
    Provide the access token from the previous step
  </Step>

  <Step title="Start indexing">
    Click `Connect` to begin indexing your Dropbox files
  </Step>
</Steps>