Fix OneDrive WebDAV Permission Errors in Zotero
Question details
Zotero is unable to access a OneDrive WebDAV URL due to permission errors, despite the connection working successfully in other clients like WinSCP.

- Product
- Microsoft OneDrive / Zotero
- Device & OS
- not provided
- Scenario
- Attempting to sync Zotero research files using a custom OneDrive WebDAV connection.
- Observed behavior
- Zotero displays a WebDAV permission or access error during sync verification, while the same URL and login credentials function perfectly when tested in WinSCP.
Ensure you have your exact OneDrive CID (Customer ID) to build the correct WebDAV URL, and verify that your Microsoft account is not currently locked out due to multiple failed login attempts.
Verify Zotero Credentials Against WinSCP Settings
Since the connection works in WinSCP, ensure Zotero is configured with the exact same URL format and authentication details without hidden spaces.
Zotero's WebDAV client is highly sensitive to formatting and authentication methods compared to more flexible FTP/WebDAV clients like WinSCP. Mismatched URLs or missing app passwords are the most common culprits for this error.
Open WinSCP, right-click your saved OneDrive WebDAV session, and select 'Edit' to reveal the exact Host name and User name.
Launch Zotero, navigate to Edit > Preferences (Windows) or Zotero > Settings (Mac), and click on the 'Sync' tab.
Under 'File Syncing', check the box to 'Sync attachment files in My Library using', select 'WebDAV' from the dropdown, and paste the exact URL from WinSCP.
Enter your Microsoft email and password, ensure there are no trailing spaces, and click the 'Verify Server' button.

Correct the WebDAV URL Formatting
Zotero requires a strict URL structure to locate the specific sync directory on your OneDrive server.
Seamlessly Manage Your Documents with WPS Office
If you are experiencing integration, syncing, or permission issues with Microsoft services like OneDrive, consider switching to WPS Office. It provides a lightweight, highly compatible document management alternative with built-in cloud storage options, ensuring your files are always accessible without complex WebDAV configurations.
- 1. Download and install: Download WPS Office from the official website and follow the installation wizard.
- 2. Connect your cloud storage: Open WPS Office, go to 'Open' on the homepage, and sign in to access WPS Cloud or connect your preferred third-party cloud drive directly.
- 3. Open and edit files effortlessly: Open your Microsoft Office documents from the cloud, edit them with full formatting support, and save them automatically.

Frequently Asked Questions
Why does WebDAV work in WinSCP but fail in Zotero?
WinSCP and Zotero handle WebDAV authentication differently. WinSCP is more forgiving with URL redirects and supports interactive authentication prompts, whereas Zotero strictly requires direct Basic Authentication support and precise URL formatting.
How do I fix the Zotero WebDAV connection if I have Microsoft 2FA enabled?
If Two-Step Verification is active on your Microsoft account, your regular password will trigger a permission error in Zotero. Log in to your Microsoft Account Security dashboard, navigate to Advanced Security Options, and generate a new 'App Password' to use specifically inside Zotero's WebDAV password field.
Does OneDrive officially support third-party WebDAV sync?
Microsoft provides legacy WebDAV support for OneDrive (via the d.docs.live.net domain), but it is not officially optimized for continuous third-party app syncing. Because of API limitations and frequent authentication token timeouts, users often experience random permission errors when syncing large libraries.




