> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropbox

## What's Supported

### Supported Actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://api.dropboxapi.com`.

## Before You Get Started

To integrate Dropbox with Ampersand, you will need a [Dropbox Account](https://www.dropbox.com/register).

Once your account is created, you'll need to create an app in Dropbox, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

* App Key
* App Secret

You will then use these credentials to connect your application to Ampersand.

### Create a Dropbox Account

Here's how you can sign up for a Dropbox account:

* Go to the [Dropbox Sign Up page](https://www.dropbox.com/register) and create an account.
* Sign up using your preferred method.

### Creating a Dropbox App

Follow the steps below to create a Dropbox app:

1. Log in to your [Dropbox Developer Console](https://www.dropbox.com/developers/apps).
2. Click **Create app**.
3. Select **Scoped access**. This defines the level of scopes for your app.
4. Choose the type of access your app needs (*Full Dropbox* or *App folder*).
5. Enter the **Name of your app**.

<br />

<img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/6d3f25b-dropbox-app-create.gif?s=e21785022f27f3bba863e5b8215ef91d" alt="Alt text" width="1440" height="704" data-path="images/provider-guides/6d3f25b-dropbox-app-create.gif" />

6. Accept the **Dropbox API Terms and Conditions**.
7. Click **Create app**.

You'll find the **App Key** and **App Secret** keys for your app in the app **Settings** section. Note these credentials as they are necessary for connecting your app to Ampersand.

### Setting Scopes for Your Dropbox App

1. In the **Permissions** section, check the boxes next to the scopes that you need for your application.

<img src="https://mintcdn.com/ampersand-24eb5c1a/i4a56x-Fmj6u7jdE/images/provider-guides/b546e59-dropbox-scopes.gif?s=faa47fd2080c1e7f2d49302e75809024" alt="Alt text" width="1440" height="704" data-path="images/provider-guides/b546e59-dropbox-scopes.gif" />

### Adding Ampersand Redirect URI

1. In the **OAuth 2 Redirect URIs** section, enter the Ampersand **Redirect URI**: `https://api.withampersand.com/callbacks/v1/oauth`.

<img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/91eaa5d-dropbox-redirect-uri.gif?s=0a250541e0da71bc05471449888e82b4" alt="Alt text" width="1440" height="704" data-path="images/provider-guides/91eaa5d-dropbox-redirect-uri.gif" />

<br />

## Add Your Dropbox App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Dropbox integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Alt text" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider apps**.

4. Select *Dropbox* from the **Provider** list.

5. Enter the previously obtained *App Key* in the **Client ID** field and the *App Secret* in the **Client Secret** field.

<img src="https://mintcdn.com/ampersand-24eb5c1a/i4a56x-Fmj6u7jdE/images/provider-guides/b4cc0e4-dropbox2.gif?s=5fa965be45dac4554015100cb4c1794f" alt="Alt text" width="1440" height="704" data-path="images/provider-guides/b4cc0e4-dropbox2.gif" />

6. Click **Save changes**.