Dropbox Connector

Dropbox Connector

Sync files and folders from Dropbox into LH42.

Features

• Files - Documents, PDFs, text files
• Folders - Recursive folder sync
• Dropbox Paper - Paper documents as markdown
• Shared folders - Team shared content
• Incremental sync - Delta-based change detection
• Selective sync - Choose specific folders

Prerequisites

1. Dropbox account (Basic, Plus, or Business)
2. Folder access permissions

Setup

Step 1: Connect via OAuth

1. Go to Settings > Integrations
2. Find Dropbox and click Connect
3. Sign in with your Dropbox account
4. Grant the requested permissions

Step 2: Configure Sync Settings

client.connectors.configure("dropbox", {
    "settings": {
        "root_folder": "/Documents/Company",    # Optional: limit to folder
        "include_shared": True,                  # Include shared folders
        "include_paper": True,                   # Include Dropbox Paper
        "file_extensions": [".txt", ".md", ".pdf", ".docx"],
        "max_file_size_mb": 50
    }
})

Options:

• Omit root_folder to sync entire Dropbox
• file_extensions - Limit to specific types
• include_paper - Sync Dropbox Paper documents

Step 3: Start Initial Sync

client.connectors.sync("dropbox", mode="full")

Supported File Types

API Reference

List Files

GET /api/connectors/{connector_id}/files?path=/Documents&limit=50

# Response
{
  "files": [
    {
      "id": "file_abc123",
      "path": "/Documents/report.pdf",
      "name": "report.pdf",
      "size": 1024000,
      "modified": "2026-01-20T10:30:00Z",
      "synced": true
    }
  ]
}

List Folders

GET /api/connectors/{connector_id}/folders?path=/

Sync Specific Folder

POST /api/connectors/{connector_id}/sync
{
  "mode": "incremental",
  "filters": {
    "paths": ["/Documents/Team"]
  }
}

Delta Sync

Dropbox provides efficient delta-based sync:

1. First sync records a cursor position
2. Subsequent syncs fetch only changes since cursor
3. Handles additions, modifications, and deletions

# Status shows cursor position
status = client.connectors.get_sync_status("dropbox")
print(f"Cursor: {status.cursor}")
print(f"Last delta: {status.last_sync}")

Dropbox Paper

Dropbox Paper documents are converted to markdown:

• Headings, lists, tables preserved
• Images referenced as links
• Comments and mentions included
• Embedded content expanded

Sync Frequency

Troubleshooting

"Path not found" errors

• Verify the folder path exists
• Check for case sensitivity in paths

Missing files

• Verify file extension is in allowed list
• Check file isn't over size limit

Slow initial sync

• Large Dropbox accounts take longer
• Use folder filters to limit scope

Next Steps

• Box Connector - Connect Box
• Integrations Overview - Architecture overview