Find availability - Automate.ax

findAvailability turns free/busy data into candidate slots that are clear on every selected calendar.

Example

import { automation, onHttpRequest } from "automate.ax"
import { findAvailability } from "automate.ax/google-calendar"

export default automation("Find interview slots", () => {
  onHttpRequest({ scope: "automation" })

  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

calendars (1–50), RFC 3339 timeMin/timeMax, and durationMinutes (1–1,440) are required. stepMinutes controls the candidate-start increment and defaults to 15; limit defaults to 20 and accepts 1–1,000. timeZone and account are optional.

Output

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

⌘I