Skip to Content
MosaicMosaicDocs
Tool Reference

CreateBookingLink

Create a reusable booking page, not a calendar meeting.

Starter documentation. Features and account details may differ from this deployment.

CreateBookingLink

Create a reusable booking page, not a calendar meeting. First use ListBookingLinks to discover a suitable existing link or reuse availability. Supply a full draft with all seven weekdays (Sunday=0), IANA time zone, and real host IDs; personal links use the authenticated user and individual mode. For a team use a real team ID and collective or roundRobin mode. Set enabled only when the user wants to accept bookings. No invitations are sent by creating a link. Repeating an identical draft with the same slug reuses the saved link; a different draft at that slug conflicts. Create or edit booking links only after conversational confirmation, with no review card or interactive form. First explain all proposed details clearly in your reply: personal or team ownership, named hosts and who attends, meeting name, description, duration, location, Mosaic call, or Google Meet, time zone, weekly hours and date exceptions, link name, buffers, minimum notice, booking window, slot interval, daily limit, guest questions and whether bookings are enabled. Ask whether to proceed and stop. Only in a later turn after the user approves that specific proposal, call this tool with their approving reply quoted verbatim in userConfirmation. The original request is not confirmation; never invent or paraphrase approval. Never ask the user for teamId, host IDs, schedule IDs, revisions or JSON: discover IDs with ListBookingLinks and ListTeamMembers. Default to personal ownership unless a team is requested, and clarify ambiguous choices by name. After execution, share the saved URL with an <m-booking-link-mention> chip (profileId/slug/url from the result), not a bare URL. Returns actual saved IDs, revision, full draft and shareable URL. Manual approval must be false; guest booking requires a connected, synced writable calendar. For video, set mosaicCall (preferred) or googleMeet, never both. Booking a mosaicCall link creates the call and attaches its join link to the invitation.

Parameters

ParameterTypeRequiredDescription
teamIdstringNoExisting Mosaic team ID discovered through tools, never requested from the user. Use null for a personal booking link.
draftBookingLinkDraftYesComplete proposal reviewed and validated before saving.
userConfirmationstringYesThe user's reply approving the specific proposal you already showed them, quoted verbatim. Never use their original request, paraphrase their reply, or invent approval.

On this page