Cliniko, Halaxy and Nookal — Two-Way Practice Software Integration is Here

Why a Real Integration Matters

Grounded Scribe is not a Practice Management System. We do not handle invoicing, Medicare claiming, or the financial side of running a practice — those are the strengths of platforms like Cliniko, Halaxy, and Nookal, and the right answer for most practices is to use a purpose-built PMS for the business side.

The wrong answer is to use them in parallel. Without integration, every appointment lives in two systems, every patient has to be entered twice, and every finished note has to be copy-pasted across. Practitioners we surveyed early in this work were spending twenty to forty minutes a week purely on cross-platform reconciliation — opening the PMS, finding the appointment, copying the note in, marking it complete, switching back.

The new integration removes that workflow. The two systems stay specialised. The friction in between disappears.

---

What Two-Way Integration Actually Means

It is easy to claim "PMS integration" when the integration is really one-way appointment sync. The new suite goes much further. Here is the actual scope, identical across Cliniko, Halaxy, and Nookal:

1. Bulk patient import on first connect

The moment you connect your PMS, Grounded Scribe imports your patient list — with deduplication against any clients you have already added. The import paginates through your full patient roster (we removed an old 2,500-patient cap that affected larger practices) and handles patients without email or mobile gracefully. A patient who exists in both systems is matched and linked, not duplicated.

2. Two-way appointment sync, 30-day window

Appointments sync across a rolling window: 30 days back and 30 days forward, refreshing continuously. The 30-days-back window was a deliberate widening from the previous 7 days — practitioners told us that documenting against last month's appointments was a common workflow, especially when catching up on missed notes or running monthly reviews. The window is wide enough to cover almost every realistic backfill case without overwhelming the sync.

The sync is two-way. Move an appointment in Grounded Scribe, it moves in your PMS. Move it in your PMS, it moves in Grounded Scribe — within seconds for Halaxy (which supports webhooks), and within the next sync cycle for Cliniko and Nookal.

3. Auto-push notes back to the patient record

When you finish a session note in Grounded Scribe, it can be pushed straight back into the corresponding patient's record in your PMS — formatted with structured headings, paragraph spacing, and a link back to the source session if you want to review the full transcript or audio later.

The first push for each connection is automatically saved as a draft in the PMS, not a finalised note. This is the safety net: you can verify the integration looks the way you expect before notes start landing as final. After that first sanity check, every subsequent push respects your preference — draft or finalised — set per-user.

4. Calendar actions write back to the PMS

If you cancel, reschedule, or change the practitioner on an appointment from inside Grounded Scribe, those changes propagate back to the PMS. Previously some practitioner-side calendar actions were silently local-only — they now write back through the integration so the PMS stays canonical.

5. Conflict resolution when patient fields disagree

A common headache with two-way sync is "the phone number is different on each side, which wins?" The new suite makes this explicit. When a patient's mobile, email, or date of birth differs between Grounded Scribe and the PMS, a sync conflict is created. You see them all in one place at Settings → Integrations → Sync conflicts, and you can resolve them individually (keep PMS, keep Grounded Scribe, or merge) or in bulk by field.

Prior conflict decisions are remembered. If you have already said "always trust the PMS for mobile numbers", the same field appearing on a different patient does not re-prompt.

6. Real-time stale-connection alerts

Tokens expire. API keys get rotated. Practices reorganise their PMS account and forget that an old integration is still pointing at it. Previously, you might not notice for days that your notes were no longer pushing.

The new sync-health monitor watches every connection continuously. If a PMS connection fails for more than a few hours, the practitioner gets an in-app alert with a one-click reconnect, and the calendar shows a prominent PMS sync failed banner so it cannot be missed. For practice owners, a weekly digest summarises any stuck integrations across the team, so a missed alert is caught at the organisational level.

7. Webhook-driven near-real-time sync where supported

Halaxy supports webhooks — when something changes in the PMS, the PMS pings Grounded Scribe and we update within seconds. Cliniko and Nookal do not currently expose first-party webhooks, so their sync runs on an hourly cron. The integration page tells you exactly which mode each connection is using, so there are no surprises.

---

What This Looks Like in Practice

A composite picture from a typical solo allied health practitioner running Cliniko:

Monday morning, 8:55am. They open Grounded Scribe on their laptop. The calendar already shows the day's appointments — synced overnight from Cliniko. The first patient's profile is linked, opens with one click, and shows their last note, treatment plan, and recent outcome scores.

During the session, the practitioner records as normal. At the end, the note is generated, reviewed, and edited. They click Push to Cliniko. The structured note appears in the patient's Cliniko record fifteen seconds later, with headings preserved. The first time they did this, it landed as a draft for sanity-check; from then on, it lands as a finalised note matching their preference.

Mid-afternoon, a patient calls to reschedule. The practitioner moves the appointment in Cliniko (faster on mobile). By the time they are back at their laptop, the move has already propagated to Grounded Scribe — appointment slot updated, no double-handling.

Later that week, their Cliniko API key is rotated as part of a security review. Within an hour, an alert in Grounded Scribe flags the disconnected integration. They click reconnect, paste the new key, and the sync resumes — no notes lost, no appointments stranded.

That is the goal of the integration: the practitioner stops thinking about the seam between the two systems.

---

Picking the Right PMS for Your Practice

A frequent question: "Which PMS works best with Grounded Scribe?" The honest answer is *all three to the same standard*, with small operational differences:

• Cliniko — the most popular allied-health choice in Australia. Wide template library, strong invoicing, well-built mobile app. Sync is hourly because the PMS does not offer first-party webhooks; for most workflows this is fast enough.
• Halaxy — strong on Medicare and bulk-billing workflows, common in psychology and counselling. Supports webhooks, so sync is near-real-time.
• Nookal — strong on multi-practitioner and clinic-management workflows. Sync runs on the hourly cycle (no first-party webhooks yet); fast enough for most workflows.

If you are not on a PMS yet and asking which one to pick, the answer is whichever fits your billing and front-of-house needs best. The Grounded Scribe integration is at parity across all three.

---

What You Need to Do

Three steps:

1. Visit Settings → Integrations. Pick your PMS.
2. Paste in the API key or complete the OAuth flow (depending on the PMS).
3. Confirm the bulk-import preview, set your auto-push preference, and you are done.

The first sync (bulk patient import) typically completes within a few minutes for practices with a few hundred patients, longer for very large practices. After that, sync is continuous and invisible.

A small number of practices have wired up more than one PMS in the past. The new suite enforces one PMS connection per user — connecting a second one will prompt to replace the first. This is to keep the canonical source of truth clear: patients, appointments, and pushed notes belong to one system, not two.

---

Built-in Safeguards

A few decisions worth flagging:

• First push is always draft. This was deliberate — the first time a note lands in your PMS, you should verify the formatting before notes start landing as final. After that, the preference is yours.
• Conflict resolution is explicit. When fields disagree, the platform asks. It does not silently overwrite.
• Disconnect cascades cleanly. Disconnecting a PMS unlinks clients, appointments, and pushed-note references — without deleting the underlying records. You can reconnect later and the matching will rebuild.
• Errors are surfaced, not buried. Sync errors appear in the practice owner's admin error log with structured diagnostics, so issues are caught and explained rather than silently failing in the background.

---

What Is Next

The current scope covers the integrations our users asked for most. The roadmap continues with: Splose (NDIS practice management), Lumary, Cliniq, and a generic CSV-import fallback for practices on niche or legacy systems. Real-time Cliniko sync remains dependent on Cliniko itself shipping a webhook API; we will switch over the moment they do.

If your PMS is not on the list and you would like it to be, let us know — patterns established with the existing three make adding new integrations significantly faster than it used to be.

---

*Practice Management Software integrations write to your patient records. Always review the first pushed note in your PMS to confirm formatting before relying on auto-push. The practitioner is responsible for the accuracy and completeness of all clinical records, in Grounded Scribe and in the connected PMS.*

---