Important: Use v12.0.2 or newer of this SDK for compatibility with the Dropbox API servers. Older versions stopped working in January 2026. Please refer to this blog post for more information: https://dropbox.tech/developers/api-server-certificate-changes

https://cfl.dropboxstatic.com/static/images/sdk/python_banner.png

https://img.shields.io/pypi/pyversions/dropbox.svg

https://img.shields.io/pypi/v/dropbox.svg

https://codecov.io/gh/dropbox/dropbox-sdk-python/branch/main/graph/badge.svg

The official Dropbox SDK for Python.

Documentation can be found on Read The Docs.

Requirements

This SDK requires Python 3.11 or newer. Earlier versions of Python, including Python 2.7 and Python 3.4 through 3.10, are not supported, as they have reached end of life and are no longer maintained upstream.

Installation

Create an app via the Developer Console.

Install via pip:

$ pip install dropbox

Install from source:

$ git clone git://github.com/dropbox/dropbox-sdk-python.git
$ cd dropbox-sdk-python
$ pip install .

After installation, follow one of our Examples or read the documentation on Read The Docs.

You can also view our OAuth Guide.

Examples

We provide Examples to help get you started with a lot of the basic functionality in the SDK.

OAuth
- Commandline OAuth Basic - Shows a simple example of commandline oauth (no redirect).
- Commandline OAuth Scopes - Shows a simple example of commandline oauth using scopes.
- Commandline OAuth PKCE - Shows a simple example of commandline oauth using PKCE.
Other Examples
- Updown - Sample application that uploads the contents of your Downloads folder to Dropbox.
- Reliable file transfer - Downloads and uploads files with retry, progress, and content validation helpers.
- Backup and Restore - Sample application that shows how you can backup a file and restore previous versions if the file was modified/corrupted in any way.

Reliable File Transfers

Use dropbox.file_transfer when copying Dropbox files to or from local storage and you want retry, progress, validation, byte/file targets, stream/file sources, and optional parallel ranged transfers around the generated files_* methods.

import dropbox
from dropbox import files
from dropbox.file_transfer import (
    DownloadOptions,
    File,
    FileUpload,
    Uploader,
    UploadOptions,
    Downloader,
)

dbx = dropbox.Dropbox("YOUR_ACCESS_TOKEN")

Downloader(dbx).download(
    "/large-file.bin",
    File("large-file.bin"),
    DownloadOptions(parallel_downloads=4),
)

Uploader(dbx).upload(
    FileUpload("large-file.bin"),
    files.CommitInfo("/large-file.bin", mode=files.WriteMode.overwrite),
    UploadOptions(parallel_uploads=4),
)

Getting Help

If you find a bug, please see CONTRIBUTING.md for information on how to report it.

If you need help that is not specific to this SDK, please reach out to Dropbox Support.

License

This SDK is distributed under the MIT license, please see LICENSE for more information.

Metadata

Release files for dropbox 12.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dropbox 12.2.3
File	Size	Uploaded
dropbox-12.2.3.tar.gz	1.3 MB	Oct 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dropbox 12.2.3
File	Interpreter	ABI	Platform	Reset
dropbox-12.2.3-py3-none-any.whl 712.4 kB Oct 7, 2026	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / dropbox-12.2.3.tar.gz

Download URL	dropbox-12.2.3.tar.gz
Size	1.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`e644ea6fd3125865a28d591c8a5408157a86fbcc517caabe76be262dd96d7157`
BLAKE2b-256 checksum How to use checksums	`f4ec26d1a23f0c155f6783fe1278d3a1e6c8e8802cada778039006d8b7942459`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dropbox/dropbox-sdk-python
Publishing commit: github.com/dropbox/dropbox-sdk-python/tree/3dfe03e64c9cb14888eb92204f1c3fdd10e622ee

Workflow

Publishing configuration: github.com/dropbox/dropbox-sdk-python/blob/3dfe03e64c9cb14888eb92204f1c3fdd10e622ee/.github/workflows/pypiupload.yml
Publishing logs: github.com/dropbox/dropbox-sdk-python/actions/runs/37662402785/attempts/1

Artifact

Subject: dropbox-12.2.3.tar.gz
SHA-256 checksum: e644ea6fd3125865a28d591c8a5408157a86fbcc517caabe76be262dd96d7157 Verifying attestations

Release files / dropbox-12.2.3-py3-none-any.whl

Download URL	dropbox-12.2.3-py3-none-any.whl
Size	712.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b0356df1f2f2021c6147fc1fbf89cf024e602388f77391c57d8068972aa1a1d0`
BLAKE2b-256 checksum How to use checksums	`de01c8cb45346fd2df249d6f6a311ec25cd84c37c8f549f5f204d09586a1debf`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dropbox/dropbox-sdk-python
Publishing commit: github.com/dropbox/dropbox-sdk-python/tree/3dfe03e64c9cb14888eb92204f1c3fdd10e622ee

Workflow

Publishing configuration: github.com/dropbox/dropbox-sdk-python/blob/3dfe03e64c9cb14888eb92204f1c3fdd10e622ee/.github/workflows/pypiupload.yml
Publishing logs: github.com/dropbox/dropbox-sdk-python/actions/runs/37662402785/attempts/1

Artifact

Subject: dropbox-12.2.3-py3-none-any.whl
SHA-256 checksum: b0356df1f2f2021c6147fc1fbf89cf024e602388f77391c57d8068972aa1a1d0 Verifying attestations