Skip to main content

Practice Setup

Connect Cliniko

Connect your practice to Cliniko, check what your region supports, and review the connection before using patient sync or result delivery.

5 steps · 3 min read

Checked against the product on .

Cliniko’s current API key instructions: Cliniko API key help

Examples for

Choose the example region. This does not change your practice or account country.

Before you start

  • Choose the intended practice before you connect. Use a practice owner or account with integration settings permission.
  • Have access to Cliniko My Info and Manage API keys. Use an active practitioner’s key if you need treatment-note uploads.
  • ClientForms detects the Cliniko shard from the key. AU/NZ and US/Canada have different settings and automation capabilities.
5 steps in this guide.Steps
Watch this task (17 seconds)A short overview of connecting Cliniko and checking result delivery, for an Australian or New Zealand practice. The Cliniko screens are illustrations.YouTube, captions, no sound. Opens in a new tab.

Step 1: Open the Cliniko integration

You

As a practice owner or admin, open Settings, Integrations, then Cliniko. Members can read this guide but cannot manage the connection.

What you should seeSettings → Integrations → Cliniko opens your connection settings.

If this looks different

If the connection already exists, inspect its Connected card and preferences. Do not create another key just to follow a new-connection guide.

Step 2: Create a Cliniko API key

You

In Cliniko, open My Info and Manage API keys. Create a key for this connection and copy it when shown. Follow Cliniko’s current help if API access needs to be enabled. Keep the key private.

Cliniko connection wizardSeparate interactive example for this step. Uses made-up details. Changes here do not change your practice.

Use the word EXAMPLE in the key field to try the next step. Keep your real API key in your practice settings.

Set up Cliniko

Region detected automatically · about 2 min · included on your plan

  1. 1 · Create key
  2. 2 · Paste & connect
  3. 3 · Choose what syncs

Step 1 of 3

Create your key

In Cliniko: your name (top-right) → My Info → Manage API keys → Create new API key. The key is shown once — copy it before you close the page. Create it under a Cliniko login linked to an active practitioner so ClientForms can create treatment notes. Administrator access alone does not establish practitioner status.

Your region is detected automatically from your API key.

View the setup guide

What you should seeCliniko shows the new API key once. Copy it before closing that page.

If this looks different

API-key management is in Cliniko, outside this example. Keep the key private; never paste it into a guide or support email.

Step 3: Paste the key in the connection wizard

You

Paste it into Cliniko API key and follow the wizard. The region is detected from the key. Check the account and region shown before confirming.

Cliniko connection wizardSeparate interactive example for this step. Uses made-up details. Changes here do not change your practice.

Use the word EXAMPLE in the key field to try the next step. Keep your real API key in your practice settings.

Set up Cliniko

Region detected automatically · about 2 min · included on your plan

  1. 1 · Create key
  2. 2 · Paste & connect
  3. 3 · Choose what syncs

Step 1 of 3

Create your key

In Cliniko: your name (top-right) → My Info → Manage API keys → Create new API key. The key is shown once — copy it before you close the page. Create it under a Cliniko login linked to an active practitioner so ClientForms can create treatment notes. Administrator access alone does not establish practitioner status.

Your region is detected automatically from your API key.

View the setup guide

What you should seeAfter Connect, the wizard confirms the key and detected region. This checks authentication, not every clinical write operation.

If this looks different

If connection fails, copy the full key again and check it belongs to the intended Cliniko account. A note-permission notice means that user cannot create treatment notes.

Step 4: Review what your connection does

You

AU/NZ uses the Cliniko sync settings. US/Canada uses a results-only connection for notes and PDFs, with separate preferences. New connections in both regions ask which Cliniko patients to bring in; US/Canada also offers creation when no match is found. New-client onboarding automation remains AU/NZ only. Check the choice and connection state before you continue.

Choose which Cliniko patients to bring inSeparate interactive example for this step. Uses made-up details. Changes here do not change your practice.

Key verified · Region detected: Australia (au5)

Which Cliniko patients should we bring in?

We copy each person’s name, date of birth, email and phone into ClientForms, so you can send an assessment without retyping. Copying changes nothing in Cliniko.

After this, people added to Cliniko come across when you open Clients. Anyone outside this choice can still be found by name from Add client.

Nothing is copied until you press Start import.

What you should seeOn a new connection, the next step asks which Cliniko patients to bring in. Nothing is copied until Start import or Finish setup.

If this looks different

Choose No one for now if you want to find people by name as needed. US/Canada also offers creation of new Cliniko patients when no match is found. Existing connections can have a different card without this step.

Step 5: Confirm the connected state

You

Finish the wizard and check the connected account and available settings. Review sync status separately; a saved key does not prove a patient or result has been delivered.

Cliniko connection statusSeparate interactive example for this step. Uses made-up details. Changes here do not change your practice.

Cliniko Integration — Connected

Region: Australia (au5)

Connected: 2 Oct 2026

Clients stay in Cliniko. Find them by name from Add client.

What you should seeThe connection card states Connected and the import or sync state. AU/NZ and US/Canada expose their respective delivery preferences.

If this looks different

Connected does not prove a PDF or note has been delivered. Check the result delivery status on a confirmed patient. If import or sync fails, follow the card’s retry and status controls rather than reconnecting blindly.

Frequently asked questions

Does turning registration off stop results reaching Cliniko?

Turning registration off does not disable your configured assessment-result delivery. Notes and PDFs still follow your Cliniko sync settings; registration answers are not collected or written back while it is off. For AU and NZ practices, a consent signed before a Cliniko link exists is sent once when the client is linked, automatically or by someone at your practice, or when two records are combined. Importing patients does not send consents, and clients linked by hand before this was added are not sent their earlier consents automatically. US/Canada keeps its separate results connection; this AU/NZ consent catch-up does not apply there. Check the client’s record to confirm delivery.

Do files clients attach on registration reach Cliniko?

In Australia, yes. When a client attaches a file on your registration form and their record is linked to a Cliniko patient, a copy is added to that patient’s files in Cliniko. It is named after your question and the date, never the client’s own file name. If the registration was matched to an existing client by the details they typed, it isn’t copied by itself: open the file to check it’s theirs, then press Copy to Cliniko on the record. The record shows each file’s state, such as Copied to Cliniko or Needs you. Files are not copied to PracSuite or Coreplus.

Does Heidi connect through ClientForms?

No. Heidi has its own Cliniko connection. ClientForms sends its assessment results through its own connection; scribe notes are a separate workflow.

Can a team member connect the practice?

Only an owner or admin can manage integrations. Ask the practice owner to set it up.

Ready to try a different approach?

Calm forms for the people filling them in. Scored results and reports for you.

Setup in 2 minutes
Cancel anytime
Email support

Full Professional access for 30 days, no card. Then a free plan with 3 forms and 10 responses.

Quiet design. Real impact.