Query free/busy - Automate.ax

googleCalendar.queryFreeBusy returns busy intervals without event details for people, rooms, or Google Groups.

Example

import { automation, onDashboardRun } from "automate.ax"
import { googleCalendar } from "automate.ax/google-calendar"

export default automation("Check team conflicts", () => {
  onDashboardRun({ title: "Check team conflicts" })

  googleCalendar.queryFreeBusy({
    calendars: ["Team Calendar", "room-1@example.com"],
    timeMin: "2026-08-10T09:00:00-07:00",
    timeMax: "2026-08-10T17:00:00-07:00",
    timeZone: "America/Los_Angeles",
  })
})

Inputs

Provide calendars as an array of 1–50 exact calendar titles, IDs, or Google Group IDs. You must also provide timeMin and timeMax in RFC 3339 format, and the end must follow the start. timeZone optionally controls the response timezone. Second argument { account } selects the Google Account.

Output

interface FreeBusyResult {
  timeMin: string
  timeMax: string
  calendars: Array<{
    calendarId: string
    busy: Array<{ start: string; end: string }>
    errors: Array<{ domain?: string; reason?: string }>
  }>
}

Busy starts are inclusive and ends are exclusive. Inspect each calendar’s errors. Google can return partial results when it can’t access a calendar or expand a group.