Skip to main content

Calendar Links GraphQL API

query CalendarLinks($organizationId: Int!, $calendarId: Int, $search: String) {
  calendarLinks(organizationId: $organizationId, calendarId: $calendarId, search: $search, orderBy: "-created") {
    items { calendarLinkId calendarId label isSystem organizationConnectionId tokenHint lastFetchedAt }
  }
}

The query also accepts platform filter and orderBy strings. search performs a case-insensitive partial match against the link label, which is useful for picker and data-grid queries. It never exposes the full token.

mutation IssueCalendarLink($input: IssueCalendarLinkInput!) {
  issueCalendarLink(input: $input) { calendarLinkId calendarId label isSystem tokenHint path }
}

Input fields are organizationId, calendarId, optional label, and optional organizationConnectionId. Supplying a connection ID creates an idempotent system link. The returned path contains the token and is shown only by this mutation; store it securely and prefix it with the API host when an absolute URL is required.

deleteCalendarLink(input: { organizationId, calendarLinkId }) revokes a user link. System links follow the organization connection lifecycle and cannot be deleted through this mutation.