All docs

Manage appointments

Approve or decline requests, cancel bookings, mark no-shows, and understand the emails and calendar invites that go out.

Updated . 5 min read.

Where to find appointments

  • Bookings shows an Upcoming list, grouped by day, across all your pages.
  • Open a booking page and choose Scheduled bookings to see everyone who booked that page, split into Upcoming and Past & cancelled.

Each row shows the invitee's name, email, optional phone, the date and time, the location, and their answers to your booking questions. A badge shows the status: Confirmed, Pending, Cancelled, Rescheduled, or Expired. On a team booking the row also shows who is meeting the invitee.

Approve or decline a request

If you turned on Require host confirmation before bookings are confirmed (on the page's Details tab), new bookings arrive as Pending. Choose Approve to confirm the booking, or Decline to reject it. The invitee is emailed either way.

A pending booking keeps its time slot while you decide. If nobody approves it within 48 hours (or before the meeting starts, if that comes first) it expires: the time is released, the invitee is told, and a payment is refunded.

Calendar event not written

If your calendar could not be reached when a booking was confirmed, the booking still stands. Formspring keeps retrying in the background and the row says Calendar event not written yet. If every retry fails the row says the event could not be written; choose Retry calendar sync (or use the API or retry_booking_calendar_sync). A retry never creates a second event.

Cancel a booking

Choose Cancel on an upcoming booking, then Yes, cancel to confirm (or Keep to back out). The invitee is notified. If they paid when booking, everything they paid (the deposit and any balance) is refunded in full. The refund runs in the background and is retried if the payment provider is unavailable; the row shows refund in progress until it goes through, and refund failed, retrying if it has not yet. The same works through the API (POST /bookings/appointments/{id}/cancel) and cancel_booking_appointment.

When an invitee cancels inside the free-cancellation window you set, their payment is not refunded automatically; you can still refund it from the payment itself.

Collect the balance of a deposit booking

If a page takes a deposit, the booking row shows what was paid and what is still due. Choose Request balance to email the invitee a secure checkout link for exactly the amount left. Asking again while a request is open returns it instead of sending another. The booking is marked balance paid when the payment provider confirms the payment, never before. Use the API (POST /bookings/appointments/{id}/balance) or request_booking_balance to do the same from your own tools.

Refund all or part of a booking

Choose Refund on a paid booking to send back part or all of what is left. The amount is taken from the deposit first, then the balance. It works on a cancelled booking too, so you can still refund an invitee who cancelled inside your free-cancellation window (that refund is not automatic). Every refund is written to the workspace audit trail. Use the API (POST /bookings/appointments/{id}/refund, which accepts an Idempotency-Key) or refund_booking_payment to do the same from your own tools.

An invitee who cancels up to your free-cancellation window before the start is refunded automatically in full; one who cancels later is not, and a host cancelling always refunds in full.

Rooms, locations and pools

A room, location or piece of equipment hosts one appointment at a time, or as many as you set under Bookings at once. In the page's settings, under Room or location, pick one (or add a new one). Every page that books into the same room shares it: a time it is in use, or outside its opening hours, is not offered, and two invitees can never take it at once, even on different pages or at the same moment. Group sessions on one page share their room for the identical session. Cancelling a booking frees the room.

A pool of rooms stands for several interchangeable rooms. Add the rooms to the pool with Member of pool, then point a page at the pool: each booking takes whichever room is free, and a time is offered while at least one room can hold the whole appointment. Each room can have its own opening hours and capacity; a booking has to fit inside one opening window of a single day.

Rooms and pools can also be managed with the API (/bookings/resources) and the list_booking_resources, save_booking_resource, delete_booking_resource and set_booking_page_resource tools.

Invitees can also cancel or reschedule themselves with the Reschedule or cancel link in their confirmation email.

Mark a no-show

Once a confirmed appointment has ended, a Mark no-show button appears in the past list. Choose Clear no-show to undo it.

Calendar invites and meeting links

  • With a connected Google Calendar, Formspring creates the calendar event, adds the invitee as an attendee, and removes the event when the booking is cancelled.
  • If there is no writable calendar (none connected, or only a read-only iCal feed), the confirmation email carries an .ics invite instead.
  • The location you chose (Google Meet, Teams, Zoom, phone, on site, or custom) appears in the confirmation email with your join link or details.
  • Zoom links can be created automatically once a Zoom account is connected, where Zoom is available for your workspace.

Emails

Email When
Booking received / pending A new booking arrives; the host is told, and the invitee is told if approval is needed
Booking confirmed The booking is confirmed or approved
Reminder 24 hours and 1 hour before the appointment
Booking cancelled Either side cancels

You can add extra addresses to notify on Notifications, and turn on a custom Confirmation message for invitees.

Next