Setting up OneDrive & Dropbox (your own app registration)
Last reviewed: 2026-10-30
You normally don’t need this page: Plainva ships its own app ID for OneDrive and Dropbox — you pick the provider, click Sign in with Microsoft… or Sign in with Dropbox… and sign in. You need your own (free) app registration in two cases only: when a corporate restriction blocks the bundled sign-in, or when you deliberately want the connection under your own control. For OneDrive you enter it under Sign-in on this device → Change → Own client ID — on the account page or in the wizard, on the desktop and on the phone alike, for this device only. For Dropbox it works the same way: in the wizard under Other sign-in → Own app key, or on the account page under Access on this device → Sign-in on this device → Change. The app key applies to this device, other devices keep their setting; an app key an account already had earlier is carried over automatically. Either way you enter a single public value:
- OneDrive → a Client ID (format
00000000-0000-0000-0000-000000000000) - Dropbox → an App Key (a short string)
Both registrations are free, need no credit card and no paid subscription. You do not need a secret password (client secret) — the values above are public and safe to store.
This page is the detailed companion to the short versions under Sync Setup.
For both providers the bundled ID is already in place — you only need Part A or Part B for your own registration.
Part A — OneDrive (Microsoft Entra)
Prerequisite: a Microsoft account (the same one whose OneDrive you want to sync). On first sign-in Microsoft automatically creates a free directory for you — no Azure subscription is needed.
1. Open the portal
- Go to entra.microsoft.com (
portal.azure.comalso works). - Sign in with your Microsoft account.
2. Create a new app registration
-
Menu Identity → Applications → App registrations, then + New registration.
-
Name: free choice, e.g.
Plainva(display only). -
Supported account types: choose “Accounts in any organizational directory … and personal Microsoft accounts”. Only this option matches Plainva’s sign-in endpoint; “this directory only” makes personal OneDrive accounts fail.
-
Redirect URI — do this right here:
- Platform: “Public client/native (mobile & desktop)”.
- Value:
http://localhost(exactly like this — no port, no trailing slash).
⚠️ Do not pick “Web” or “SPA”. “Web” requires a client secret and sign-in will fail.
-
Register.
3. Copy the Client ID
On the app’s Overview, copy the “Application (client) ID” — that is your value for Plainva. (You do not need the “Directory (tenant) ID”.)
4. Allow public client flows
- Menu Authentication.
- At the very bottom, set “Allow public client flows” to Yes.
- Save.
5. Set the permissions
- Menu API permissions → + Add a permission → Microsoft Graph → Delegated permissions.
- Tick both:
Files.ReadWriteoffline_access(provides the long-lived sign-in token — without it Plainva refuses to connect)
- Add. Admin consent is not needed for personal accounts; you consent yourself at sign-in.
Enter it in Plainva
- Settings → your vault → Cloud accounts: open the Microsoft account, or start Connect account… with the Microsoft tile.
- At Sign-in on this device choose Change, then Own client ID.
- Paste the copied Application ID into the Client ID field and Save.
- Sign in again (in the wizard: Sign in with Microsoft…) → sign in in the browser and confirm access. The browser then tells you that you can close the window.
Part B — Dropbox
Prerequisite: a Dropbox account.
1. Open the app console
- Go to dropbox.com/developers/apps and sign in.
- Click Create app.
2. Choose the app type
-
Choose an API: Scoped access.
-
Type of access: Full Dropbox — not “App folder”.
⚠️ Full Dropbox is required: “App folder” only sees an isolated subfolder and won’t find existing vaults elsewhere in your Dropbox.
-
Name: a globally unique name, e.g.
Plainva-Sync-<yourname>(technical only, nobody else sees it). -
Create app.
3. Register the redirect URI
Tab Settings → OAuth 2 → Redirect URIs: enter exactly http://127.0.0.1:41953 and click Add.
⚠️ It must match character for character:
127.0.0.1(notlocalhost), port41953, no trailing slash. Plainva binds this exact port; any deviation aborts sign-in.
4. Set the permissions
Tab Permissions — tick the following and click Submit at the bottom:
account_info.readfiles.metadata.readfiles.content.readfiles.content.write
⚠️ If you change the permissions later, you must Sign in again in Plainva, otherwise the old rights still apply.
5. Copy the App key
Tab Settings: copy the App key value — that is your value for Plainva. (You do not need the “App secret”.)
Your app stays in “Development” status. That is enough for private use; “Apply for production” is only needed if many other people use the same App key.
Enter it in Plainva
- Settings → your vault → Cloud accounts: open the Dropbox account or start Connect account… with the Dropbox tile.
- In the wizard open Other sign-in and choose Own app key; on the account page choose Access on this device → Sign-in on this device → Change instead.
- Paste the copied App key and Save.
- Sign in with Dropbox… (on the account page Sign in again) → sign in in the browser and confirm access. You pick the cloud folder (default
/Plainva) afterwards via Choose folder….
If something goes wrong
| Symptom | Cause | Fix |
|---|---|---|
| OneDrive: “Microsoft returned no refresh_token” | offline_access missing | Step A5: add offline_access, then Sign in again |
| OneDrive: login asks for a secret / fails | Platform “Web” instead of “Mobile and desktop” | Step A2: platform Public client/native, redirect http://localhost |
| OneDrive: personal account is rejected | Wrong account type | Step A2: choose ”… and personal Microsoft accounts” |
| Dropbox: sign-in hangs / “redirect_uri mismatch” | Redirect not exact | Step B3: exactly http://127.0.0.1:41953 |
| Dropbox: “Port 41953 is in use” | Another program blocks the port | Close the blocking application, try again |
| Dropbox: can’t find the vault / missing rights | ”App folder” instead of “Full Dropbox”, or permissions not Submitted | Check step B2 / B4, then Sign in again |
See also
- Sync Setup — short version and the other providers
- Sync Compatibility — which services work and how
- FAQ & Troubleshooting