Connect Hero Health

Connecting Hero Health lets patients book your real availability on Quokka. We read your diary when someone opens your profile, and any booking made on Quokka is written back into Hero as a confirmed appointment — the right patient, the right clinician, the right time. You carry on working in Hero exactly as you do now.

The video follows a patient rather than the portal, because the part worth seeing is the part you cannot watch from inside Quokka: a stranger paying online, and the appointment appearing in Hero. The card at the end is not a mock-up — every value on it was read back out of Hero over the API after the booking was made.

What you need

Two things from your Hero Health account:

• Your API key
• Your practice group ID

Both come from Hero. If you are not sure which practice group you are, ask Hero support — it is a short number, and getting it wrong is the most common reason a connection fails.

Connect it

1. In your portal, open Connect your practice system
2. Choose Hero Health
3. Pick your environment — Production, unless Hero has told you otherwise
4. Paste your API key and your practice group ID
5. Select Connect

That is the whole of it. Your sites, your clinicians and your appointment types arrive on their own, along with their durations and prices.

What arrives, and what does not

Comes across automatically	Stays yours to set
Locations, with addresses	Which locations are actually yours (see below)
Clinicians, with their roles	The specialty shown on each clinician's profile
Appointment types, with durations and prices	Which Quokka category each one belongs to
Live availability, read fresh each time	Your description, photos and FAQs

Hero lists referral destinations alongside your own sites. Hospitals your consultants refer into appear in the same list as the clinics you run, and we cannot tell them apart. Hide the ones that are not yours on the Locations screen — once you have, we will not un-hide them on a later sync.

Match your services to categories

Patients search by category — "GP appointment", "blood test" — not by the name a service has in your diary. So each category a patient can search needs one of your appointment types behind it.

Most of this is done for you when you connect. What is left is usually your own shorthand, which only you can rule on. Until a category has an appointment type, patients searching for it will not find you.

When a patient books

The patient pays when they book. Quokka takes the payment and passes it to your Stripe account, minus the platform fee — see When you get paid.

The appointment is created in Hero and confirmed, not left as a provisional hold. It carries the patient's name and date of birth so you can match them to a record, and it is marked as paid elsewhere, so Hero will not raise a second invoice for it.

Troubleshooting

The connection is refused. Check the environment first, then the practice group ID, then the key. An expired or revoked key and a wrong practice group produce a similar-looking failure.

Times show, but nobody can book. That is usually the category matching above: your availability is being read, but no category points at the appointment type behind it.

A clinician's name reads oddly. Names arrive in the format your diary sorts them by. We reformat them for patients, but if one is wrong at source it is worth fixing in Hero, since that is where it is read from.

An appointment did not appear in Hero. Bookings that fail to sync are shown on your Bookings screen with the reason, rather than being lost — the money is still taken, and the booking still exists on Quokka. Tell us if you see one; that is a fault at our end, not yours.