Sync with iCloud CalDAV

There are two iCloud methods

2Do's recommended iCloud sync needs no account details at all and carries everything: see Sync with iCloud. The page you are reading covers iCloud CalDAV, the credential-based route that signs in with your Apple Account and an app-specific password. Choose it when non-Apple devices or other CalDAV task apps need to read the same lists.

iCloud CalDAV lets 2Do read and write tasks through iCloud using the CalDAV protocol. Because CalDAV is an open standard, the same task lists are readable by other CalDAV apps, including clients on Android and Windows.

Reminders is separate

Apple's Reminders app does not read CalDAV task lists. Tasks synced through iCloud CalDAV do not appear in Reminders, and changes made in Reminders do not reach 2Do. If you want your tasks inside Reminders, use the Apple Reminders sync method instead.

Lists and Task Calendars

Every 2Do list you sync through iCloud CalDAV is stored in iCloud as a task calendar, the CalDAV name for a collection that holds tasks rather than events. It is the same container as your list in 2Do, under a different name: 2Do shows it as a List, while other apps may label the identical collection a task calendar, a task list, or simply a calendar. A calendar app such as BusyCal, for example, shows the same iCloud collection among its task calendars.

Changes travel in both directions:

• Create a list in 2Do and the matching task calendar appears in iCloud; rename the list and iCloud follows.
• A task calendar created in another CalDAV app arrives in 2Do as an ordinary list.
• Only apps that read iCloud over CalDAV can see these collections, which is why the same list turns up in some apps and not others.

What iCloud CalDAV Carries

• Core task fields: title, notes, dates, alerts, recurrence, priority, action, location, and sub-tasks.
• Multiple alerts per task sync through iCloud CalDAV as they are.
• One picture and one audio recording per task, controlled by the Sync pictures and Sync audio notes switches under the account.

Two more switches sit alongside them: Sync list ordering keeps your list order the same across devices, and Sync app preferences carries your 2Do settings between devices.

What Stays on This Device

Some 2Do-only features are not carried by CalDAV sync and stay on this device:

• Smart Lists
• Tag groups
• List groups
• Unused tags

The paused state of a tag is also per device, so pausing a tag on one device leaves it active on the others.

note

Other apps and devices signed in to this account see your projects and checklists as a flat list of tasks.

For a sync that carries your whole 2Do setup, including Smart Lists, tag groups, list groups, and every attachment, use iCloud or Dropbox.

App-Specific Password Requirement

Apple requires two-factor authentication for any third-party app that reaches iCloud, so your normal Apple Account password does not work here. Generate an app-specific password at appleid.apple.com under Sign-In and Security > App-Specific Passwords, and enter that in 2Do.

App-specific passwords can be reused across apps and devices. Save yours somewhere secure, or generate a new one any time.

Best Practices

Keep these points in mind:

• Use your @icloud.com address, not @mac.com. If your Apple Account also has an @mac.com address, enter the @icloud.com one in 2Do.
• Use your primary Apple Account, not an alias. iCloud aliases do not work for CalDAV sign-in, only the primary email address that owns the account.
• Set your device's date and time to automatic. Under iOS Settings > General > Date & Time, turn on Set Automatically. If the device clock is wrong, the app-specific password fails without an obvious reason.
• Resetting your Apple Account password revokes every app-specific password. Generate a new one and enter it in 2Do again.

Setup

1. Make sure two-factor authentication is on for your Apple Account.
2. Generate an app-specific password at appleid.apple.com under Sign-In and Security > App-Specific Passwords. Label it 2Do so you can revoke it later.
3. Open Settings > Sync and stay on the Setup tab.
4. Open Account Type and choose iCloud CalDAV.
5. Enter your Apple Account and the App-Specific Password you generated.
6. Tap Set Up Sync. 2Do connects, discovers your iCloud task calendars, and starts syncing.
7. Repeat on each device with the same Apple Account. The first device populates iCloud; the others use Replace Local Data to pull it down.

Your first sync

When both sides already hold data, 2Do asks how to combine them. Read Merge vs Replace before choosing. You can run any of those choices again later from Settings > Sync > Next sync action; it applies once, then returns to Sync Normally.

Daily Sync

iCloud CalDAV syncs when you open 2Do, when iOS grants background time, and whenever you pull down on the task list.

Troubleshooting

"Password is incorrect", or a cryptic -1012 error

Most often this is one of:

1. You entered your normal Apple Account password instead of an app-specific password. Generate one at appleid.apple.com and use that.
2. The app-specific password was revoked because you reset your Apple Account password. Generate a new one.
3. The device clock is wrong. Turn on iOS Settings > General > Date & Time > Set Automatically.
4. You used an alias or an @mac.com address. Use your primary @icloud.com address.

If none of those help, remove the account from 2Do and add it again: Settings > Sync > Change Account, then set it up with a freshly generated app-specific password.

"Forbidden" during sync

This usually means the credentials are not accepted at all, typically for one of the reasons above. Generate a fresh app-specific password and enter it again.

Duplicate tasks

If tasks suddenly appear twice, the same iCloud tasks may be reaching 2Do through two paths, for example another device syncing the same lists through a different method. Settle on one method for every device and sync again.

Tasks that live in Reminders do not appear

Reminders stores its lists in Apple's own Reminders system rather than on iCloud CalDAV, so a list that exists only inside Reminders cannot sync through this method. Use the Apple Reminders sync method if you want those lists in 2Do.

507 Insufficient Storage Error

Your iCloud account is out of storage. Free up space in iCloud, then sync again.

301 Moved Permanently

Apple occasionally moves CalDAV endpoints. Update 2Do to the latest version; current builds follow Apple's redirects automatically.

A list you deleted comes back

This usually means another device still holds that list and pushes it up again. Delete the list on all devices, then sync.

Setting Up Another Device

• Adding another device: install 2Do, set up iCloud CalDAV against the exact same Apple Account (with an app-specific password), and let the first sync pull your data down. See Setting up a new device.
• One device showing different tasks: sync the most up-to-date device, then choose Replace Local Data on the ones that are behind. See One of my devices isn't syncing correctly.
• Choosing a direction: picking the wrong side can overwrite good data. Read Merge vs Replace before confirming.

Tips

tip

If you rely on Siri to capture tasks into Reminders, remember that this method syncs iCloud CalDAV task lists, not Apple Reminders.

tip

If you want every 2Do feature and all attachments to sync, iCloud carries them in full and needs no password.