Repository files navigation

Important: Make sure you're using v12.0.2 or newer of this SDK by January 2026 for continued compatibility with the Dropbox API servers. Please refer to this blog post for more information:https://dropbox.tech/developers/api-server-certificate-changes

The offical Dropbox SDK for Python.

Documentation can be found onRead The Docs.

Create an app via theDeveloper Console.

Install viapip:

$pip install dropbox

Install from source:

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

After installation, follow one of ourExamples or read the documentation onRead The Docs.

You can also view ourOAuth Guide.

We provideExamples 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 yourDownloads folder to Dropbox.
  • 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.

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

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

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