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
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.
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.
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
- 1 · Create key
- 2 · Paste & connect
- 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.
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.
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
- 1 · Create key
- 2 · Paste & connect
- 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.
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.
Key verified · Region detected: Australia (au5)
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 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.
Related guides
Send onboarding forms automatically from Cliniko
Book a new client in Cliniko and your onboarding forms go out to them on their own, without anyone pressing Send.
Use scribes alongside Cliniko
Keep scribe notes and assessment results as separate Cliniko workflows. Check each service’s connection and destination before relying on a record.
Send an assessment
Start on the client's page, press Send assessment, choose the forms, then email it, copy the link or do it together in the room. Scored results appear on the client's page.

Ready to try a different approach?
Calm forms for the people filling them in. Scored results and reports for you.
Full Professional access for 30 days, no card. Then a free plan with 3 forms and 10 responses.
Quiet design. Real impact.