Medos Booking Docs

What is Medos Booking

Understand what the widget does, who it's for, and how it fits into your site.

Medos Booking is an embeddable healthcare booking widget you can add to any website. It handles the entire booking journey — doctor selection, slot picking, patient identification via OTP, and confirmation — and talks to the Medos backend so your site doesn't need to.

What the widget does

  • Lists doctors and clinic locations for a Medos workspace
  • Shows available appointment slots
  • Handles phone-based OTP identification for the patient
  • Creates the booking (scheduled appointment, session-pack redemption, or queue token) via the Medos API
  • Confirms the booking to the patient in-widget

Who it's for

  • Clinics and hospitals that want a booking flow on their marketing site
  • Healthcare platforms embedding Medos-powered booking inside their own product
  • Agencies and developers building websites for medical practices

How you install it

The widget ships as a single CDN script tag. Drop the tag onto any page and call MedosBooking.init(...) with your API key. That's the whole integration.

Three booking flows, one widget

The widget adapts its UI based on each doctor's appointmentSystemType:

System typeWhat patients see
SCHEDULEDClassic appointment picker with dates and time slots.
SCHEDULED_WITH_PACKAGESSame as scheduled, plus session-pack selection.
QMSLive queue banner and a token number on confirmation.

You don't configure this — the widget reads each doctor's setting and picks the right UI automatically. See How the widget adapts.

What's not covered here (yet)

This site currently documents the widget only. REST API, webhooks, and dashboard guides will arrive in later releases and share the same sidebar so navigation stays stable.

On this page