Calendars

Connect a CalDAV calendar

Connects a CalDAV calendar (Apple iCloud, Fastmail, Nextcloud, or custom) using password-based authentication. Verifies credentials before storing.

post/v1/calendars/caldav/connect

Request

  • Base URL: https://api.astrocal.dev
  • URL: https://api.astrocal.dev/v1/calendars/caldav/connect
  • Auth: HTTP bearer

Request body

member_idstring uuid required

The org member whose calendar is being connected

preset'apple' | 'fastmail' | 'nextcloud' | 'custom' required
server_urlstring uri
usernamestring required
passwordstring required

Response

CalDAV calendar connected

idstring uuid required
providerstring required
calendar_idstring required
account_emailstring required
member_idstring uuid required
member_namestring nullable required

The owning member's email address, or null when unknown

connected_atstring required
status'active' | 'needs_reauth' required
last_sync_atstring nullable required
sync_status'connected' | 'expired' | 'error' required
sync_errorstring nullable required
upcoming_booking_countinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.