WorkestraDocs
Integrations

iCloud Calendar (CalDAV)

Connect Apple iCloud Calendar via CalDAV for free/busy reads and event writes.

Apple iCloud's calendar is accessible to third parties through the CalDAV protocol. Workestra connects via app-specific passwords — the standard approach for any third-party calendar tool integrating with iCloud.

Use this when:

  • Your team uses iCloud Calendar (the macOS / iOS native app) instead of Google or Microsoft
  • You're a freelancer or small team where iCloud is the primary calendar
  • You need free/busy reads and event writes against iCloud calendars

For Workspace (G Suite) Apple businesses, this is the option — Google Calendar isn't iCloud, even if your domain is hosted on Apple's mail.

iCloud CalDAV connect form

Screenshot needed — /settings/integrations/icloud with Apple ID + app-specific-password fields

What it does

Workestra eventiCloud result
Booking computedFree/busy read via CalDAV REPORT query
Booking confirmedCalendar event written via CalDAV PUT (iCalendar VEVENT)
Booking rescheduledEvent updated via CalDAV PUT with the new time
Booking cancelledEvent deleted via CalDAV DELETE

iCloud doesn't support online-meeting URL generation natively, so meeting URLs (Zoom, Meet, Teams, etc.) must be configured separately on the booking link.

Connecting

  1. Generate an app-specific password at appleid.apple.com → Sign-In and Security → App-Specific Passwords.
  2. /settings/integrations/icloudConnect.
  3. Enter your Apple ID email and the app-specific password.
  4. Pick the calendar to write to (your default iCloud calendar by default).
  5. Save.

Per-host — each host generates their own app-specific password. Two-factor authentication on the Apple ID is required to generate one.

Calendar selection

iCloud accounts can have multiple calendars (Work, Personal, Family). When connecting, pick the one Workestra writes to. Free/busy reads consult all calendars on the account by default — you can change this in connection settings.

What's NOT supported

  • Push notifications for calendar-side changes — CalDAV push is brittle. Workestra polls (every 10 minutes) for changes. Calendar-side delete-sync latency is up to 10 min.
  • Shared family / group calendars beyond your own subscriptions — only calendars accessible to your Apple ID.
  • Custom CalDAV servers — only iCloud's specific CalDAV endpoint.
  • Multi-account on one host — connect one Apple ID per Workestra user.