Medos Docs

Everything you need to build with Medos.

Guides, references, and examples for the Medos platform. Starting with the Booking Widget — with the REST API, webhooks, and dashboard guide arriving next.

Start with the Booking Widget Browse docs

index.html

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

<button onclick="MedosBooking.open()">Book appointment</button>

<script>
  MedosBooking.init({
    apiKey: "mk_your_publishable_key",
    mode: "modal",
  });
</script>

Products

Pick where you want to start

Each product has its own section of the docs. Only the Booking Widget is available today — the others land as we ship them.

Available

Booking Widget

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

Coming soon

REST API

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

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.