Create booking

tidyCal.createBooking books one time slot or a package of time slots.

automations/create-tidycal-booking.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { tidyCal } from "automate.ax/tidycal"

export default automation("Create TidyCal booking", () => {
  onDashboardRun({ title: "Create TidyCal booking" })
  tidyCal.createBooking({
    bookingTypeId: 123,
    startsAt: "2026-08-28T18:00:00Z",
    name: "Ada Lovelace",
    email: "ada@example.com",
    timezone: "America/Los_Angeles",
    bookingQuestions: [
      { bookingTypeQuestionId: 456, answer: "Analytical engines" },
    ],
  })
})

Provide either startsAt for one booking or bookings: [{ startsAt }] for a package. name, email, and timezone are always required. A question answer can be a string or an array of strings. The action returns one booking for a single request or an array for a package. TidyCal returns 409 when a slot is unavailable, a duplicate was submitted within five minutes, or another request held the slot lock. Check availability immediately before booking, but still handle conflicts because availability can change.

Built-in triggers

Built-in actions

Runtime utilities

Integrations