# Dropbox

> Source: https://truto.one/docs/integration-guides/dropbox/

## Install Dropbox integration

The Dropbox integration can be found [here](https://app.truto.one/integrations/available/13d96651-3a61-46dd-9159-42df6817d8b1). Please install it in your environments before proceeding with the steps below.

## Creating a Dropbox app to use with Truto

:::callout{type="warning"}
This integration is built with Dropbox Business API in mind. So please make sure you connect a Dropbox Business account.

:::

1. Go to [Dropbox App Console](https://www.dropbox.com/developers/apps/create).
2. Select **Scoped access**, and then select **Full Dropbox** and finally enter a name for your app. Click on **Create app**.
   ![Create Dropbox app](https://docs-assets.truto.one/dropbox-create-oauth.png)
3. On the app details page, scroll down to OAuth 2 section and the Redirect URI. ![Dropbox redirect uri](https://docs-assets.truto.one/dropbox-redirect-uri.png)
4. Then move on to the Permissions tab and select the [permissions based on the Unified APIs](/docs/integration-guides/dropbox#unified-api-scopes) you want to use with this integration. [Refer the table below](/docs/integration-guides/dropbox#unified-api-scopes). ![Dropbox permissions](https://docs-assets.truto.one/dropbox-permissions-tab.png)
5. Go back to the **Settings** tab and copy the **App key** and **App secret** to enter into the Truto interface. ![Dropbox app key and secret](https://docs-assets.truto.one/dropbox-app-key-secret.png)

### Dropbox scopes to select based on the Unified APIs

| Unified API                | Scopes                                                                                                                                                                                                                                                                       |
|----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Unified User Directory API | account_info.read, team_info.read, team_data.member, members.read, groups.read                                                                                                                                                                                               |
| Unified File Storage API   | account_info.read, files.metadata.write, files.content.write, files.content.read, sharing.write, file_requests.write, contacts.write, team_info.read, team_data.member, team_data.team_space, files.team_metadata.write, files.team_metadata.read, members.read, groups.read |

## Connecting a Dropbox account

:::callout{type="warning"}
This integration is built with Dropbox Business API in mind. So please make sure you connect a Dropbox Business account.

:::

1. Click on **Connect Account**
   ![Click connect account](https://docs-assets.truto.one/truto-connect-account.png)

2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on **Get connection link**
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)

3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Dropbox account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)

4. Select Dropbox
   ![Select Dropbox](https://docs-assets.truto.one/select-dropbox.webp)

5. You'll now be asked to log in to your Dropbox account and allow access to Truto. Go through the steps.

6. _Voila!_ You should now see a connection successful message. You can now close this tab.

7. Go to your Truto account, and you should see the new Dropbox integration under **Integrated Accounts**. Click on the Account ID to view the details and initiate API calls.