Cancel Calendar Booking
Cancel a booking and give the time back. Safe to call twice, and the slot returns to the public grid.
Request
Response
Errors
An error keeps the envelope: a negative code and a message in data.
Related methods
confirm_calendar_bookinguserTurn a held slot into a real booking. A hold token that is no longer present has lost the slot and is refused rather than re-added, because re-adding it is how one time gets sold twice.
public_cancel_bookingpublicA visitor cancels their own booking from their private link, by the page's rules: whether visitors may change a booking, and up to how many hours before it starts. A paid booking is refunded first, by the page's refund percent, and stays booked if the refund fails. A paid booking on a page with no refund cannot be cancelled here.
calendar_set_planuserSwitch Xuda Calendar on, change tier, or switch it off. Tiers are free (one booking page), starter (unlimited pages, payments, SMS reminders and round robin), growth (resources, group sessions with seats, calendar sync and AI phone booking) and business (managed templates, attribute routing, webhooks and API). Paid tiers ride one line item on the consolidated subscription, so moving between them swaps the price instead of adding a second charge. Switching off clears the plan and cancels the line at the end of the period.
confirm_paid_bookingpublicConfirms an appointment once its payment has cleared. Everything is checked against Stripe on the server: the visitor arrives from a redirect and controls every value in it, so three things must agree before a slot is given away. Stripe says the payment completed; the payment names THIS appointment and THIS hold, which is what stops a receipt for a cheap slot being presented against an expensive one; and the amount collected still matches what the service costs. If the payment cleared but the slot could not be booked, that is reported rather than swallowed, because the money is real and the appointment is not.
create_booking_roomuserMake the Xuda Meet room of a video booking that was confirmed without one, and send each guest of that appointment the link. The room belongs to the appointment, so every confirmed booking of it holds the same room. Safe to call twice: a second press answers the room that exists and sends nothing again. Refused for a booking that is cancelled, already over, not a video appointment, or not the caller's.
delete_calendar_itemuserRemove a resource, a service or a booking page. Bookings are never deleted this way: they are cancelled, which frees the slot and keeps the record the money and the contact history point at.
2 of 24 in Calendar