# Dropbox Integration

Give your AI agent the ability to browse, search, and organize files and folders in Dropbox.

---

Connect Dropbox to your Chipp AI so it can browse folders, search for files, get metadata, create folders, generate sharing links, and move files -- all through natural conversation.

## What the AI Can Do

Once connected, your agent gains six tools:

| Tool | Description |
|------|-------------|
| **dropbox_list_files** | List files and folders in a directory (use empty path for root) |
| **dropbox_search** | Search for files and folders by name or content |
| **dropbox_get_file_metadata** | Get detailed metadata for a specific file or folder |
| **dropbox_create_folder** | Create a new folder at a specified path |
| **dropbox_get_sharing_link** | Create or retrieve a shared link for a file |
| **dropbox_move_file** | Move or rename a file or folder |

### Search Options

The search tool supports filtering by file category:
- Documents, spreadsheets, presentations
- Images, audio, video
- Folders

## Connecting Dropbox


  **1.** 
    <strong>Open the Integrations tab</strong>

    In your app's builder, navigate to the **Build** section and select the **Integrations** tab. Find **Dropbox** in the list of available integrations.
  


  **2.** 
    <strong>Click Connect</strong>

    Click the **Connect** button next to Dropbox. You will be redirected to Dropbox's authorization page.
  


  **3.** 
    <strong>Authorize access</strong>

    Sign in with your Dropbox account and approve the requested permissions.
  


  **4.** 
    <strong>Test it out</strong>

    Once connected, open the chat preview and try:
    - "List the files in my Dropbox root"
    - "Search for the project proposal"
    - "Create a shared link for the budget spreadsheet"
  


## How It Works

### File Browsing

The agent navigates Dropbox using folder paths. Ask it to browse a specific directory or start from the root:

- "What's in my Dropbox?" lists the root directory
- "Show me the files in /Projects/2026" browses a specific folder
- Recursive listing is supported for deep folder exploration

### Sharing Links

The agent can create or retrieve shared links for any file:

- If a shared link already exists, it returns the existing one
- If not, it creates a new public link
- Useful for quickly sharing files through conversation

### File Organization

The agent can reorganize your Dropbox:

- "Create a new folder called 'Archive' in /Projects"
- "Move the Q3 report to the Archive folder"
- "Rename the budget file to 'Budget-Final.xlsx'"

### Metadata

Each file and folder includes:
- Name and path
- File size
- Last modified date
- File type (file or folder)

## Example Use Cases

- **File lookup** -- "Find the contract for the Acme deal"
- **Folder organization** -- "Create a new project folder and move all related files into it"
- **Quick sharing** -- "Get me a sharing link for the presentation slides"
- **File discovery** -- "What files were recently modified in the Documents folder?"
- **Cleanup** -- "Search for all duplicate files and list them"

## Billing

Dropbox tool calls use your standard LLM token billing. There is no separate per-call fee.