Dropbox

Need a hand? Setting up developer credentials can sometimes feel a bit overwhelming. We offer a complimentary 15-minute onboarding session to help you get this configured perfectly. Book your session with a specialist here

When you first install Bread & Butter, the Dropbox 1-click connection may not display your own branding during the connection process if it is not fully configured for your domain.

To maximize user trust and prevent conversion drop-off, you must set up an application in the Dropbox Developer portal. This allows you to generate your own credentials so your visitors see your brand when they click "Continue with Dropbox."

Here is how to set it up in five steps.

Step 1: Create Your Dropbox App

1. Log in to the Dropbox Developer website.
   • https://www.dropbox.com/developers/
2. Click on Create apps on the Developer homepage.
3. Choose Scoped access for your app's API.
4. Choose App Folder for the type of access you need.
5. Enter an App Name. We highly recommend using your exact organization or company name, as this is what will appear to users during the login process.

6. Click Create app.

   

Step 2: Configure Your App Settings

This ensures Dropbox correctly routes your users back to your website after they authenticate.

7. Navigate to the Settings tab.
8. Scroll down to the OAuth 2 section. Under Redirect URIs, paste the following exact link:
9. https://api.breadbutter.io/callback  
10. Click Add.

Step 3: Complete the Production Application

Dropbox requires you to manually set the app to production before public users can connect.

10. Still on the Settings page, look for and click Apply for production.
11. Follow the on-screen steps to complete the production application process. Note: This is strictly required in order for standard users to authenticate with your App.

Step 4: Generate Your App Credentials

12. Once your app is approved for production, locate your credentials on the App page.

⚠️ Important: Copy and save both your App Key (which acts as your Client ID) and your App Secret (which acts as your Client Secret). You will need them to connect Bread & Butter in the final step.

Step 5: Link Your Credentials to Bread & Butter

13. Log in to your Bread & Butter dashboard.
    • https://app.breadbutter.io
14. Go to Settings in the left menu, then navigate to your Global Conversion Methods tab.
15. Locate your Dropbox connection and edit the settings to switch from Sandbox to Production Mode.
16. Enter a custom name and description for your reference.
17. Paste your App Key into the Client ID field.
18. Paste your App Secret into the Client Secret field.
19. Click Save, and ensure the checkbox next to your new Dropbox provider is enabled.

Final Polish: Complete Your White-Label Setup

You have successfully added your brand name to the Google consent screen! However, visitors may still see breadbutter.io       listed in the URL routing during the connection process.

To completely remove our branding and keep visitors fully within your own domain ecosystem, navigate to the Custom Auth Domain tab in your Bread & Butter settings to set up your Custom Auth Domain.

• For more information, see: What is a Custom Auth Domain, and how do I set it up?