> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.airweave.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server. # Dropbox > Dropbox integration with Airweave {/* AUTO-GENERATED CONTENT START */} Dropbox logo

Dropbox

This connector enables AI agents and RAG systems to retrieve context from Dropbox through Airweave's unified search layer. ## Configuration Dropbox source connector integrates with the Dropbox API to extract and synchronize files. Connects to folder structures from your Dropbox account. It supports downloading and processing files. #### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/dropbox.py) Explore the Dropbox connector implementation ### Authentication This connector uses **OAuth 2.0 with custom credentials**. You need to provide your OAuth application's Client ID and Client Secret, then complete the OAuth consent flow. #### OAuth Setup Required 1. Create an OAuth application in your provider's developer console 2. Enter your Client ID and Client Secret when configuring the connection 3. Complete the OAuth consent flow ### Configuration Options This connector does not have any additional configuration options. ## Data Models The following data models are available for this connector: #### DropboxAccountEntity Schema for Dropbox account-level entities based on the Dropbox API. Reference: [https://www.dropbox.com/developers/documentation/http/documentation#users-get\_current\_account](https://www.dropbox.com/developers/documentation/http/documentation#users-get_current_account) | Field | Type | Description | | ------------------- | --------------- | ----------------------------------------------------------- | | account\_id | str | Dropbox account ID | | display\_name | str | Display name for the account | | abbreviated\_name | Optional\[str] | Abbreviated form of the person's name (typically initials) | | familiar\_name | Optional\[str] | Locale-dependent name (usually given name in US) | | given\_name | Optional\[str] | Also known as first name | | surname | Optional\[str] | Also known as last name or family name | | email | Optional\[str] | The user's email address | | email\_verified | bool | Whether the user has verified their email address | | disabled | bool | Whether the user has been disabled | | account\_type | Optional\[str] | Type of account (basic, pro, business, etc.) | | is\_teammate | bool | Whether this user is a teammate of the current user | | is\_paired | bool | Whether the user has both personal and work accounts linked | | team\_member\_id | Optional\[str] | The user's unique team member ID (if part of a team) | | locale | Optional\[str] | The language that the user specified (IETF language tag) | | country | Optional\[str] | The user's two-letter country code (ISO 3166-1) | | profile\_photo\_url | Optional\[str] | URL for the profile photo | | referral\_link | Optional\[str] | The user's referral link | | space\_used | Optional\[int] | The user's total space usage in bytes | | space\_allocated | Optional\[int] | The user's total space allocation in bytes | | team\_info | Optional\[Dict] | Information about the team if user is a member | | root\_info | Optional\[Dict] | Information about the user's root namespace | #### DropboxFolderEntity Schema for Dropbox folder entities matching the Dropbox API. Reference: [https://www.dropbox.com/developers/documentation/http/documentation#files-list\_folder](https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder) | Field | Type | Description | | ---------------- | ---------------------- | ---------------------------------------- | | id | str | Dropbox folder ID | | name | str | Folder name | | path\_lower | Optional\[str] | Lowercase full path starting with slash | | path\_display | Optional\[str] | Display path with proper casing | | sharing\_info | Optional\[Dict] | Sharing information for the folder | | read\_only | bool | Whether the folder is read-only | | traverse\_only | bool | Whether the folder can only be traversed | | no\_access | bool | Whether the folder cannot be accessed | | property\_groups | Optional\[List\[Dict]] | Custom properties and tags | #### DropboxFileEntity Schema for Dropbox file entities matching the Dropbox API. Reference: [https://www.dropbox.com/developers/documentation/http/documentation#files-list\_folder](https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder) | Field | Type | Description | | ------------------------------ | --------------- | ----------------------------------------- | | id | str | Dropbox file ID | | name | str | File name | | path\_lower | Optional\[str] | Lowercase full path in Dropbox | | path\_display | Optional\[str] | Display path with proper casing | | rev | Optional\[str] | Unique identifier for the file revision | | client\_modified | Optional\[Any] | When file was modified by client | | server\_modified | Optional\[Any] | When file was modified on server | | is\_downloadable | bool | Whether file can be downloaded directly | | content\_hash | Optional\[str] | Dropbox content hash for integrity checks | | sharing\_info | Optional\[Dict] | Sharing information for the file | | has\_explicit\_shared\_members | Optional\[bool] | Whether file has explicit shared members | {/* AUTO-GENERATED CONTENT END */} ## Integrate Airweave with Dropbox APIs on localhost Airweave will access Dropbox on behalf of your users. You'll need to have each Dropbox provides [documentation](https://developers.dropbox.com/oauth-guide) on how to implement OAuth 2.0. This guide will walk you through connecting Dropbox APIs to Airweave when running locally. 1. Go [here](https://www.dropbox.com/developers/apps/create) to create the "Airweave integration" application 2. Under `Settings`, add the Redirect URI. Use the appropriate URL for your environment: **Production (Airweave Cloud):** ``` https://api.airweave.ai/source-connections/callback ``` **Local:** ``` http://localhost:8001/source-connections/callback ``` 3.Under `Permissions`, select the following scopes: ``` account_info.read files.metadata.read files.content.read profile email ``` 4. Locate the `App key` and `App secret` under `Settings`. Add these credentials to the `dev.integrations.yml` file to enable Dropbox API integration.