Troubleshooting
Troubleshooting CalDAV Connections Both
Diagnostic checklist for troubleshooting CalDAV synchronization with Apple Reminders, DAVx⁵, Thunderbird, Fantastical, and Home Assistant.
1. "401 Unauthorized" or Invalid Password
- Use App Passwords: CalDAV clients must authenticate using an App Password generated in Settings → Developer → App Passwords.
- Verify Scopes: Ensure your App Password was issued with both
tasks:readandtasks:writepermissions. - Account Email: In the CalDAV username field, always enter your full TapTidy account email address.
2. "Unable to Create Calendar" or MKCALENDAR Errors
- Single Collection Architecture: TapTidy hosts a single, unified tasks calendar collection per account. It intentionally rejects
MKCALENDARrequests to create secondary remote calendars. - Client Setup Prompt: If your client's initial setup wizard asks you to name or create a new calendar, cancel that prompt and select the existing discovered tasks collection.
3. Client-Specific Configuration Tips
Apple Reminders & macOS
Add account type Other CalDAV Account → Account Type: Manual. Set Server Address to your instance domain, Path to /caldav, Port 443 with SSL enabled.
DAVx⁵ (Android)
Select Login with URL and user name. Enter base URL https://your-domain.com/caldav. Ensure the sync interval is set to periodic or push.