Find availability - Automate.ax

googleCalendar.findAvailability turns free/busy data into available time slots.

Example

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

export default automation("Find interview slots", () => {
  onDashboardRun({ title: "Find interview slots" })

  googleCalendar.findAvailability({
    calendars: ["recruiter@example.com", "room-1@example.com"],
    timeMin: "2026-08-10T09:00:00-07:00",
    timeMax: "2026-08-10T17:00:00-07:00",
    durationMinutes: 45,
    stepMinutes: 15,
    limit: 10,
  })
})

Inputs

Provide 1–50 entries in calendars, timeMin and timeMax as RFC 3339 timestamps, and durationMinutes from 1–1,440. stepMinutes controls the candidate-start increment and defaults to 15. limit defaults to 20 and accepts 1–1,000. timeZone is optional. Optional second argument { account } selects the Google Account.

Output

Returns Signal<Array<{ start: string; end: string; durationMinutes: number }>> in chronological order. Times are timestamps in ISO 8601 format. The action merges overlapping busy periods from all calendars before testing candidates. The action can return overlapping candidates when stepMinutes is shorter than durationMinutes.