Dropbox

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.

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 in the Airweave UI, then go through the OAuth consent screen.

OAuth Setup Required

Create an OAuth application in your provider’s developer console
Enter your Client ID and Client Secret in the Airweave UI
Complete the OAuth consent flow when connecting the source

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.

REQUIRED fields from ChunkEntity (must be provided):

entity_id: ID of the entity this represents in the source
breadcrumbs: List of breadcrumbs for this entity (empty for top-level accounts)

OPTIONAL fields from ChunkEntity (automatically populated if available):

Other inherited fields from ChunkEntity

Field	Type	Description
account_id	str	The user’s unique Dropbox ID
name	str	Name for display representing the user’s Dropbox 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.

REQUIRED fields from ChunkEntity (must be provided):

entity_id: ID of the entity this represents in the source
breadcrumbs: List of breadcrumbs for this entity

OPTIONAL fields from ChunkEntity (automatically populated if available):

Other inherited fields from ChunkEntity

Field	Type	Description
folder_id	str	Unique identifier for the folder
name	str	The name of the folder (last path component)
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.

REQUIRED fields from FileEntity (must be provided):

file_id: ID of the file in the source system
name: Name of the file
download_url: URL to download the file

OPTIONAL fields from FileEntity (automatically populated if available):

Other inherited fields from ChunkEntity

Field	Type	Description
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[datetime]	When file was modified by client
server_modified	Optional[datetime]	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

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 on how to implement OAuth 2.0. This guide will walk you through connecting Dropbox APIs to Airweave when running locally.

Go here to create the “Airweave integration” application
Under Settings, add the following Redirect URI:

http://localhost:8080/auth/callback/dropbox

3.Under Permissions, select the following scopes:

account_info.read
files.metadata.read
files.content.read
profile
email

Locate the App key and App secret under Settings. Add these credentials to the dev.integrations.yml file to enable Dropbox API integration.