Medos Docs

Add clinic booking to any website with Medos.

Guides, API references, and live playgrounds for the Medos widgets — appointment booking, patient portal, enquiry form, and package purchase — and the server-side Developer API. Webhooks and the dashboard guide arrive next.

Start with the Booking Widget Browse docs

index.html

<script src="https://widgets.medos.one/v2/unified.js"></script>

<div id="medos-booking"></div>

<script>
  MedosBooking.init({
    apiKey: "mk_your_publishable_key",
    mode: "inline",
    containerId: "medos-booking",
  });
</script>

Products

Pick where you want to start

Each product has its own section of the docs. The widgets and the server-side API are available today — the others land as we ship them.

Available

Booking Widget

Embed appointment and queue booking into any website with one script tag.

Available

More widgets

A patient portal, an enquiry form, and package sales — each with a playground and full configuration docs.

Available

Developer API

Server-to-server access to workspaces, doctors, appointments, queue tokens and packs.

Coming soon

Webhooks

Real-time event delivery for bookings, cancellations, and status changes.

Coming soon

Dashboard

Workspace setup, doctor management, feature flags, and analytics.

Booking Widget

Get running in five minutes

Pick the path that matches your stack, grab an API key, and drop the widget on a page.

Quickstart

Script tag + init call. Works in any framework.

Get your API key

Where to find it, how to keep it safe.

Going live

Develop safely, then check everything before real patients arrive.

Booking Widget

Everything you can configure

Reference for install, configuration, theming, callbacks, and the two booking flows.

Install

CDN script tag plus framework recipes for React, Next.js, Vue, Angular, Svelte, Laravel, and more.

Configure

Every option in the init() reference, plus modal vs inline, preselecting a doctor, and overriding profiles.

Theming

Built-in themes, brand-colour shortcuts, or your own token set. CSS variables scoped to --medos-*.

Booking flows

Scheduled and queue (QMS) flows, auto-selected per doctor. Session packs are folded into scheduled.

Callbacks

onSuccess, onError, onClose. Analytics recipes for GA4, GTM, and Mixpanel.

Advanced

Languages and RTL, doctor visibility rules, and how slot timezones resolve.