A slot is a chunk of time a customer can book into. MakeTheQueue builds the list of available slots from the queue's appointmentSettings: which days of the week you're open, the slot length, and how many bookings fit in one slot.

How slots are generated

When a customer picks a date, the widget calls GET /api/v1/queues/:queueId/slots?date=YYYY-MM-DD. The API checks whether you're open that day of the week, builds the slot list, and subtracts bookings that are already taken so the customer only sees real openings.

  1. Open Settings, then Queues, and edit the queue.
  2. In the Appointments section, pick the Booking days you take bookings and the Open from and Until times.
  3. Set the Slot length (for example, 15, 30, or 60 minutes).
  4. Set Bookings per slot. If you can serve two customers at the same time, set it to 2.
  5. Save. Try booking as a customer to confirm the slots look right.

Capacity and overbooking

Capacity is enforced on the booking endpoint inside a database transaction, so two customers can't race to grab the last seat in a slot. If a slot is full, it's hidden from the booking UI.

Dates in the past

The booking endpoint rejects any date that has already passed, so customers can't accidentally book yesterday.

Common problems

  • Customer sees no available times. You're closed that day of the week, or every slot is already booked. Pick a different date.
  • Too many people showing up at once. Lower the capacity per slot or make the slots longer.
  • Slots don't match your service length. Adjust the slot length so one slot equals one appointment.
  • Customer booked and you closed early. Cancel the appointment from the Appointments page. Cancelled customers stop receiving reminder notifications.

Related articles