Get your API key
Where to find your Medos API key and how to keep it safe.
Every widget instance needs an API key to talk to the Medos backend. The key identifies your workspace and lets the widget fetch doctors, slots, and create bookings.
Where to find it
Sign in to your Medos dashboard.
Go to Developers → API Keys.
Copy the publishable key that starts with mk_.
Dashboard URL
Replace the dashboard reference above with your actual dashboard URL once it's live. This is a placeholder while the auth story is being finalized.
Key format
Medos publishable keys look like this:
mk_fa63fc512c368d6492bf03c4745467bffa63fc512c368d6492bf03c4745467bfThey're 67 characters long, always prefixed with mk_.
Safe to expose in the browser
Publishable keys are designed to be embedded in client-side code. The
widget swaps the key for a short-lived session token on init(), so the
key itself never authorizes destructive operations directly.
That said, you should still:
- Rotate keys when a developer leaves the team.
- Restrict domains in the dashboard so the key only works on your sites.
- Never commit keys for production environments to a public repo — use environment variables or a build-time inject step instead.