Booking on your website
Show your doctors and their free times on your clinic's own website. Patients pick a time there, then sign in or register with your clinic in the Rinova patient portal to book it.
Add it in three steps
1. Make a booking key
In the Rinova portal, open Settings › Integrations and choose New key under Booking on your website. List the websites that will show booking, e.g. https://www.yourclinic.com. The key works only on those.
2. Paste the code
Rinova shows the key once, with the code below already filled in. Paste it where the booking should appear on your website.
3. Patients book
Visitors choose a day, a doctor and a time. The time opens in the patient portal, where they sign in or register and confirm.
The booking widget
Works on any website: WordPress, Wix, or plain HTML. It shows the next 14 days, lets visitors filter by department, specialty and in-person or video visits, and uses your clinic's time zone.
<div id="rinova-booking"></div>
<script src="https://rinova.health/widget/booking.js"
data-key="rk_pub_your_key"
async></script>- data-key
- Your clinic's booking key. Required.
- data-target
- Where the widget goes, as a CSS selector. Default #rinova-booking.
- data-lang
- en (English) or bn (Bangla). Default en.
- data-color
- The colour of buttons and the chosen day, e.g. #1d4ed8.
Only doctors whose availability is active and set to show to the public appear. You control both on the doctor's availability in the portal.
Build your own with the booking API
If you have a developer, you can show free times in your own design. The API only reads; booking always happens in the patient portal.
Send your key with every request
fetch("https://api.rinova.health/api/v1/booking/practitioners-with-slots?date=2026-11-02", {
headers: { "X-Api-Key": "rk_pub_your_key" },
}).then((r) => r.json());Answers
{ "success": true, "data": { ... } }
{ "success": false, "error": "…", "code": "INVALID_API_KEY" }- GET /api/v1/booking/clinic
- Your clinic's name, time zone, address, phone, logo and bookingUrl. Add &slotId=<id> to bookingUrl to open a chosen time in the patient portal.
- GET /api/v1/booking/days?from=YYYY-MM-DD&days=14
- How many free times there are on each day, for a day picker. Takes the same filters as the doctors list.
- GET /api/v1/booking/specialties
- The specialties of doctors who take online bookings.
- GET /api/v1/booking/departments
- Your departments that take online bookings, each with an id and a name.
- GET /api/v1/booking/practitioners-with-slots?date=YYYY-MM-DD
- Doctors with their free times on that day (in your clinic's time zone), each with their degrees, specialty and department. Optional: specialty, department (an id from the departments list), locationType (physical, virtual or both), _count (up to 20) and _offset.
- GET /api/v1/booking/slots/:slotId
- One free time, with its doctor and place.
When something goes wrong
- 401 API_KEY_REQUIRED
- No X-Api-Key header was sent.
- 401 INVALID_API_KEY
- The key is wrong or was revoked. Make a new one in Settings.
- 403 ORIGIN_NOT_ALLOWED
- The page's website is not listed on the key. Add it under the key's websites.
- 429 RATE_LIMIT_EXCEEDED
- Too many requests from one visitor. Wait a few minutes.
Keeping your key safe
- The key sits in your website's page, so anyone can see it. That is expected: it only shows the free times your website already shows, and browsers can use it only on the websites you listed.
- It can't book, change or see appointments or patients.
- If a key is misused, revoke it in Settings › Integrations. Websites using it stop showing times within a minute. Make a new key and update your website's code.
Let patients find a time on your website.
Make a key in Settings and paste the code. Talk to us if you would like help adding it.