Calendar & Booking

`createBookingType`

Create Booking Type

Create a booking type: a scheduling link people use to book time with you (name, duration, buffers, notice, approval, guests, price, video provider).

write

Arguments

namestringrequiredName of the booking type, e.g. '30-min intro call'.
durationMinutesintegerrequiredMeeting length in minutes.
isActivebooleanoptionalPublish/enable so the link can be booked (reachable only if your profile is also public). Default false: never auto-published (consent floor).
slugstringoptionalURL handle for the link (the {bookingSlug} in /{profile}/booking/{bookingSlug}). Omit to derive one from the name. Must be unique among your types.
descriptionstringoptionalShort description for the booking page.
bufferBeforeMinutesintegeroptionalPadding reserved before each booking, in minutes.
bufferAfterMinutesintegeroptionalPadding reserved after each booking, in minutes.
minNoticeMinutesintegeroptionalMinimum notice before a slot can be booked, in minutes.
maxAdvanceDaysintegeroptionalHow far ahead the link can be booked, in days.
requiresApprovalbooleanoptionalIf true, bookings land as 'pending' until you confirm them.
allowGuestsbooleanoptionalLet the booker add extra guests.
maxGuestsintegeroptionalCap on added guests.
priceAmountnumberoptionalPrice to book, in the smallest currency unit. Omit for free.
priceCurrencystringoptionalISO 4217 currency code for priceAmount, e.g. 'USD'.
confirmationMessagestringoptionalMessage shown to the booker after they book.
callLinkTypestringoptionalCall link for confirmed bookings: 'google_meet', 'zoom', or 'teams' (needs the matching connected account), or 'cloud' for the Cloud-native call room: the default, and how you switch a type back off an external provider.
scheduleIdstringoptionalAvailability-schedule id to bind (the bookable-hours window). Omit to use your default availability.
targetCalendarIdstringoptionalCalendar id the booking event lands on (which account/calendar it books onto). Omit to route to your primary calendar.

Returns

The result states whether the link is publicly reachable and returns the real canonical URL.

Declared limits

durationMinutes: greater than 0
durationMinutes: maximum 9007199254740991
bufferBeforeMinutes: minimum 0
bufferBeforeMinutes: maximum 9007199254740991
bufferAfterMinutes: minimum 0
bufferAfterMinutes: maximum 9007199254740991
minNoticeMinutes: minimum 0
minNoticeMinutes: maximum 9007199254740991
maxAdvanceDays: greater than 0
maxAdvanceDays: maximum 9007199254740991
maxGuests: greater than 0
maxGuests: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

create a booking link
set up a 30-min intro call
make a scheduling page

Pair it with

The verbs that finish the job.