> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-square-proxy.mintlify.site/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-square-proxy/ejdbQ1e8FNJV93R0/images/provider-guides/6d3f25b-dropbox-app-create.gif?s=fe2ea6e7cc373fbc019a18f156e0fd4a" 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-square-proxy/ejdbQ1e8FNJV93R0/images/provider-guides/b546e59-dropbox-scopes.gif?s=18bfe28c6d99a3f7446fb0afa5fcf76c" 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-square-proxy/ejdbQ1e8FNJV93R0/images/provider-guides/91eaa5d-dropbox-redirect-uri.gif?s=3f664bc2fb617fcadbba990c0bc860c5" 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-square-proxy/uJIcPIMi_VTSdhsa/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=uJIcPIMi_VTSdhsa&q=85&s=8e2630317c3756eff07134cbd713cc35" 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-square-proxy/ejdbQ1e8FNJV93R0/images/provider-guides/b4cc0e4-dropbox2.gif?s=bf67fcdec99fd9f043202242c96f5191" alt="Alt text" width="1440" height="704" data-path="images/provider-guides/b4cc0e4-dropbox2.gif" />

6. Click **Save changes**.