Medos developer docs
Developer docs for Medos: booking, patient portal, enquiry and package widgets for clinic websites, and a server-side API for your own backend.
Medos Docs is the developer reference for everything you can build on top of Medos. Guides, API references, integration recipes, and best practices — all in one place.
It covers the embeddable widgets — the drop-in script tags that add healthcare booking, a patient portal, enquiries, and package sales to any website, each with its own guides and configuration reference — and the Developer API for calling Medos from your own backend. Additional product areas will land in this same site as they mature.
Widgets
Four script tags, four globals. The booking widget is documented in depth; the others get an overview, configuration, callbacks, and errors each.
All four widgets
Bundles, globals, what they share, and what they don't.
Booking widget options
Every option for MedosBooking, with its type, default, and effect.
Patient portal
Returning patients manage their own appointments and session credits.
Enquiry form
A contact form that files against your workspace.
Package purchase
Sell a multi-session package outside the booking flow.
Booking widget
The main focus of these docs. Everything you need to embed appointment and queue booking into your site.
Get Started
Grab an API key and drop the widget into your site in five minutes.
Install
CDN script tag plus step-by-step framework guides.
Configure
The full options reference for init(), open(), and close().
Theming
Built-in themes, workspace colors, and full token overrides.
System types
How the widget switches between scheduled and queue flows.
Troubleshooting
Common issues and how to fix them.
Calling Medos from your own backend
Beyond the widgets, you can call Medos directly from your server with a secret API key, locked to your servers' addresses. The Developer API is live for every Medos client — see Developer API.
Coming soon
Webhooks and the dashboard guide will land in this same site. Ask the platform team if you need them before they ship.