Skip to main content

Calendar Link

CalendarLink publishes a calendar's business hours and availability blocks as an RFC 5545 iCalendar feed. Each link has its own URL-safe token; deleting the link immediately revokes access.

FieldTypeNotes
calendarLinkIdintPrimary key
organizationIdintOrganization that owns the calendar
calendarIdintPublished calendar
labelstring?User-facing link label
isSystembooleantrue for links managed by an organization connection
organizationConnectionIdint?Connection controlling a system link
tokenHintstringLast four token characters; the full token is never returned after issuance
lastFetchedAtdatetime?Last successful authorized feed request

The feed endpoint is GET /api/calendar-feed/v1/orgs/{organizationId}/{token}/calendar_{calendarId}.ics. It is anonymous because the token is the credential, supports ETag/If-None-Match, and returns 304 when unchanged. Disabling an organization connection disables all of its system links.

Deleting a calendar is rejected while it has a system link; unlink the organization connection first.