Skip to main content

Sync with iCloud CalDAV

iCloud CalDAV syncs tasks through Apple's CalDAV service. It uses your Apple Account and an app-specific password. It works during Android's full-featured trial and requires 2Do Pro after the trial ends.

Looking for the recommended iCloud method?

Choose iCloud under Recommended to use 2Do's native iCloud sync, which signs in through your browser and carries more 2Do data. iCloud CalDAV is a separate entry under CalDAV. See Sync with iCloud.

Apple Reminders lists use a separate service. Tasks in the upgraded Reminders app do not appear in 2Do through iCloud CalDAV. See Sync with Apple Reminders.

Lists and Task Calendars​

CalDAV stores a synced 2Do list as a task calendar, a collection of tasks rather than events. Creating, renaming, or deleting a synced list changes its matching task calendar. Task calendars created in other compatible CalDAV apps can appear as lists in 2Do.

Other apps must support CalDAV tasks to use these collections. Finding the account in a calendar app does not mean it can display all of 2Do's task features.

What iCloud CalDAV Carries​

It carries supported task fields, including titles, notes, dates, alarms, repeats, priorities, tags, and the project or checklist details 2Do can exchange through CalDAV. Other CalDAV apps may show a project or checklist as ordinary tasks.

When attachment sync is enabled, this method represents up to one picture and one audio recording per task.

Limitations​

  • List groups, tag groups, Smart Lists, and saved search rules do not sync through CalDAV.
  • Additional attachments and link-only attachments are not carried by its picture and audio slots.
  • A tag's paused state stays local.
  • Other apps may not support all task fields, repeats, or multiple alarms.

Choose iCloud for fuller 2Do data exchange between supported devices.

App-Specific Password Requirement​

Your usual Apple Account password is not the password for this setup. Apple's app-specific password guide explains the requirement and account controls. Your Apple Account must use two-factor authentication to generate one.

  1. Sign in at account.apple.com.
  2. Open Sign-In and Security > App-Specific Passwords.
  3. Choose Generate an app-specific password and follow Apple's prompts. Give it a name such as 2Do Android.

Best Practices​

Use the account's sign-in email address and the app-specific password together. Do not substitute an email alias or the password for a different account.

Changing or resetting your main Apple Account password revokes its app-specific passwords. Generate another one for 2Do if that happens. Keep the device's date and time correct when diagnosing authentication failures.

Setup​

  1. Generate the app-specific password as described above.
  2. Open Settings > Sync setup > Sync Method in 2Do.
  3. Choose iCloud CalDAV under CalDAV.
  4. Under Credentials, enter your Apple Account email address as Username and the app-specific password as Password.
  5. Tap Sign in.
  6. Return to the task list and pull down to sync. If asked, read the replacement choices before selecting the copy to keep.
  7. Use the same CalDAV method and Apple Account on your other 2Do devices.

For an additional device, choose Replace data on this device when the account contains your complete copy. Make a backup before replacing separate work on the device.

Daily Sync​

Set an interval under Settings > Sync setup > Sync automatically, or pull down on the task list to request a sync. Android may delay background work.

Common Issues​

"Password is incorrect" / can't log in​

Check that the username belongs to the intended Apple Account and that you entered an app-specific password. If that password was revoked, generate another. Check the device's date, time, and connection. Repeating your usual Apple password will not authenticate this method.

Apple Reminders changes do not appear in 2Do​

Reminders lists are separate from CalDAV task calendars. Use the same supported 2Do sync method on all your devices when you want to share your own 2Do tasks across platforms.

507 Insufficient Storage error​

The server could not store the request. Check available iCloud storage, make space if needed, and retry.

301 Moved Permanently when syncing using CalDAV​

Update 2Do and retry. If it persists, send the error and 2Do's logs to support so the redirected endpoint can be checked.

Setting Up Another Device & Troubleshooting​

Use iCloud CalDAV and the same Apple Account on the additional device. It must not use the separate iCloud method if you expect the same CalDAV tasks.

For a deliberate replacement, use Settings > Sync setup > Next sync action. Replace data on this device receives the account's copy; Replace server data replaces the account's tasks with this device's copy and affects the others using it. Back up first. See replacement choices and partially synced data.

Last updated on