Skip to main content

Calendar Tasks

Calendar/IssueLink@1​

Issues an iCalendar feed link. Inputs are organizationId and calendarId, plus optional label and organizationConnectionId. Outputs are calendarLinkId, url (a relative feed path containing the one-time token), and isSystem.

- task: "Calendar/IssueLink@1"
  name: issueCalendarLink
  inputs:
    organizationId: "{{ inputs.organizationId }}"
    calendarId: "{{ inputs.calendarId }}"
    organizationConnectionId: "{{ inputs.organizationConnectionId }}"
  outputs:
    - name: url
      mapping: url

Calendar/ImportFeed@1​

Mirrors a local or remote iCalendar feed into an organization's calendar. Inputs are organizationId, url, optional existing mirror calendarId, and optional prior etag.

Outputs include status (ok, unchanged, revoked, error, or skipped), reason, calendarId, etag, businessHours, and availabilityBlocks. A revoked feed removes the mirror; fetch or parse errors leave the previous mirror untouched. Synced rows are reconciled by customValues.syncUid, while locally created rows without that value are preserved.

- task: "Calendar/ImportFeed@1"
  name: importCalendarFeed
  inputs:
    organizationId: "{{ inputs.organizationId }}"
    url: "{{ inputs.feedUrl }}"
    calendarId: "{{ vars.mirrorCalendarId }}"
    etag: "{{ vars.feedEtag }}"
  outputs:
    - name: status
      mapping: status
    - name: calendarId
      mapping: calendarId
    - name: etag
      mapping: etag