When you or your users set up a Dropbox connection (needed for Dropbox connectors) on your Website as a Service website, the authorisation message needs to show your brand instead of our brand.
This is done by registering for Dropbox API access on a Dropbox account that reflects your company/brand name.
In order for this to occur, you need to create a new Dropbox account for the purpose of gaining API access.
Simply create a new Dropbox account and make sure to use a general email address that reflects your brand's web domain.
Something like info@myapp.com or support@myapp.com would be ideal.
Once you have created this account, the next step is getting your API app keys from Dropbox:
- Go to https://www.dropbox.com/developers/apps and sign in with your Dropbox account.
- Select App Console from the left hand menu, then click Create App on the right.
You may need to accept terms and conditions along the way. - Select Dropbox API app and configure down the page as follows:
- Select Files and datastores
- Select No - My app needs access to files already on Dropbox
- Select All file types - My app needs access to a user's full Dropbox
- Enter your app name - this should just be your existing WaaS site name or branding name.
Your app name cannot contain the word "Dropbox" as it goes against Dropbox branding policy (found here: https://www.dropbox.com/developers/branding).
- Select Files and datastores
- Click Create App, you should get a "app created" message and be taken to a page with tabs.
- In the Settings tab, click on Enable additional users, then click OK in the subsequent prompt.
This allows your Dropbox API keys to be used for up to 100 Dropbox accounts (equates to 100 organisation connections on our platform). - Next, you need to set the OAuth2 Redirect URIs to point to your WaaS site.
Your OAuth2 redirect URI is found on your "customise site" page on our platform.
Simply copy the URI from there and paste into the field on the Dropbox app Settings page. - Finally, copy the App Key and App Secret, and paste these into the provided fields on your "customise site" page on our platform.
IMPORTANT NOTE
To make Dropbox available to more than 100 connections on your WaaS site, you need to request that your status be changed to "Production".
To do so, click the "Apply for Production" button found on your Dropbox app's Settings page.
For quick approval of of your app to production status you are advised to completely follow the guidelines in the branding policy.
You will likely also need to provide a few screenshots showing how you create a connection to Dropbox from the WaaS site in order to pass Dropbox's review.
Refer to the link below for more information on attaining Production status on your Dropbox account:
https://www.dropbox.com/developers/reference/devguide#production-approval