Product update

Setting up your Nookal API key

tl;dr

  • Generate a key in Nookal under Setup → Connections → API Keys, then paste it into Hanah's Nookal connection.
  • Your Nookal appointments appear in Hanah, finished notes sync to your client and case.
  • Hanah's browser extension lets you work from inside Nookal.

This guide is for Nookal practices that want an AI scribe working with their notes. Hanah is an AI medical scribe that connects to Nookal in two ways, and you can use either or both.

  • You paste an API key once, and Hanah reads your appointments and sends finished notes back to the client's case.
  • The browser extension runs on the Nookal pages you have open and fills the note form with the draft. It doesn't need a key.

We'll start with the key. It takes a few minutes and is the only step with anything to copy.

Step 1: Generate the key in Nookal

In Nookal, open Setup, then Connections, then API Keys, and generate a new key. Copy it.

A Nookal key belongs to the practice, not to one practitioner. One key covers everyone in the account, and each clinician tells Hanah which practitioner they are in the next step. You don't need a key for every clinician.

Treat the key like a password. If it ever ends up somewhere it shouldn't, delete it in Nookal and generate another. The old key stops working straight away.

Step 2: Paste it into Hanah

In Hanah, open Integrations from the left-hand menu. Click the Nookal card under API integration and paste the key into the API key field.

Hanah checks the key against Nookal as you paste it, and tells you straight away if it didn't work.

Next is Which practitioner is this? Leave it on Auto-detect by email and Hanah matches you to the Nookal practitioner with your email address. If your Nookal email is different, pick your name from the list instead. Hanah shows that practitioner's appointments, and notes you send go under them in Nookal.

The Name field is optional. It helps when you connect more than one Nookal account, for example if you work at two clinics. Hanah shows appointments from all of them.

Save, and the card shows Nookal as connected.

Practice admins see a Clinician picker at the top of the dialog. You can use it to connect a colleague with the practice key, without asking them to do it.

What the connection does

  • The day's Nookal appointments appear in Hanah, and you start a recording against the right client without typing their name.
  • A finished note goes to the Nookal client and case it came from.
  • Every note stays a draft in Hanah until you send it.

Review the note in Hanah before you send it. Nookal finalises a treatment note as soon as it arrives and has no way to edit it afterwards. Sending a corrected version adds a second note to the case.

On security, the key is stored on our servers and never sent to your browser. Deleting the key in Nookal ends the connection immediately.

Step 3: Add the browser extension

The API key links the two systems. The extension puts the draft into Nookal's note form while you're in it.

Install the Hanah extension from the Chrome Web Store, or use the Nookal card under Browser integration on the same Integrations page. Sign in to Hanah once.

Then open a client in Nookal, go to their clinical notes, and open a note template. Hanah appears beside the form. Pick the visit, generate, review the draft, and Hanah fills each question of the template in turn: Subjective goes into Subjective and Objective into Objective.

The extension works in your browser, on a page you're allowed to see. It doesn't need the API key, and it works before you've done steps 1 and 2.

Which do you need?

Browser extension API key
Setup Install, sign in Generate a key, paste it once
Fill your Nookal note template, question by question Yes No
Your Nookal appointments inside Hanah No Yes
Send finished notes to the client's case from Hanah No Yes

Most practices use both. If you write every note inside Nookal, the extension is enough. If you also want the day's appointments in Hanah and notes sent from there, add the key.

Nookal's built-in AI and Hanah

Nookal sells its assistant, JAN AI, as an add-on. Nookal's pricing page lists it at A$34 per practitioner a month on the Professional and Enterprise plans (checked 13 November 2026).

Hanah's Practice plan is A$100 per practitioner a month, or A$80 billed annually, and the Nookal integration is included. Hanah drafts notes, letters and referrals in your templates, and drafts care plans such as home exercise programs that you send to the patient through the Hanah app. It starts with a 1-month free trial and no card.

In our benchmark, Hanah, Heidi and Lyrebird took the same recorded consultations and every note was graded blind. Hanah's notes had 54% fewer errors than Heidi's and 64% fewer than Lyrebird's, and were finalised faster with less editing.

We publish our accuracy and hallucination report and the method behind it.

If you get stuck on either step, book a demo and we'll set it up with you.

Frequently asked questions

Where do I find the API key in Nookal?

In Nookal, open Setup, then Connections, then API Keys, and generate a key. Paste it into the Nookal connection under Integrations in Hanah.

Does every clinician need a Nookal API key?

No. One Nookal key covers the whole practice. Each clinician connects with that key and picks which practitioner they are, or Hanah matches them by email.

Do I need an API key to use the browser extension?

No. The extension fills the Nookal note form from the page you have open. The key is for bringing appointments into Hanah and sending notes from there.

Can I edit a note after Hanah sends it to Nookal?

Nookal finalises a note when it arrives and doesn't allow edits through its API. Review the draft in Hanah before you send it. Sending again adds a new note to the case.

Sources cited in this article

How we write, source and review articles

See Hanah in your own practice.

Book a demo