Start free trial

Cliniko integration setup

The Cliniko practice management integration is one of our popular integrations for clinics and allied health practitioners who want to send their form responses automatically to Cliniko, each time a form is submitted.

Our online forms allow you to create and receive secure digital forms for patient registration, intake, referrals, signed consent, assessments, and more.

How does the Cliniko integration work?

  • Once a client submits a completed form, it’s automatically synced to their file in your Cliniko account.
  • Got a new patient? No problem! Once they submit an intake, registration, or referral form, a new patient file will be automatically created in your Cliniko account with all their details filled in.
  • For existing patients, you’ll find a PDF copy of the form automatically attached to their Cliniko file. You can also have existing patient records updated with information from your form.

Start with an online form

Before you can integrate with Cliniko – you need to set up your online form in Snapforms.
Whether you have a brand new data collection idea or you’re already using some paper and PDF based forms, we can help you get up and running with an online form in minutes.

We recommend you check out our 10-minute getting started video or have a look through our written resources and guides to set up your form.
If you have an existing paper or PDF form and you prefer our team create a draft for you to try out, please send us your form and we’d be happy to help!

How to set up the Cliniko integration

  1. First you’ll need to generate a new API key in your Cliniko account. To get this key please follow these instructions from the Cliniko website:
  2. Once you have the key, head over to Snapfoms and edit your form. This guide assumes you’ve already created your online form using the drag-and-drop form builder. If you haven’t done this yet please follow these steps to set up your form first.
  3. Edit your form and head over to the Form Settings tab, as shown in the below image.
  4. Click the Integrations tab.
  5. Tick ‘Enable Cliniko Integration’.
  6. Enter your API key (which you generated in step 1 above).
  7. Tick ‘Create new Cliniko patient from form response’ if this form will sometimes be filled in by new clients, and you want them to be created automatically as a Patient in Cliniko.
  8. Tick ‘If patient exists in Cliniko update their details with the answers from this form’ if you want the details of existing patients to be updated based on this form response.
  9. Tick ‘Attach a PDF document to the Cliniko patient file’ if you want a PDF copy of the completed form to be attached to the Patients ‘Files’ in Cliniko.
    The recommended setup is to tick at least the ‘create new client’ and ‘send PDF copy’ options.
    By default the PDF that will be attached looks exactly like your online form. The answers from the relevant form response will be populated in the fields.
    If you do not need to customise this, you can leave everything as it is here.
    If you need to customise the default PDF, design your own PDF document from scratch or use a pre-made fillable PDF instead, click ‘Add/edit PDF templates for this form’ and follow the instructions in the PDF templates guide.
  10. Using the Field mapping settings you need to map your form fields with the relevant Cliniko patient fields. The First and Last Name fields are critical for the integration to work, so start by selecting the fields on your form that are used for the patients first and last name.
  11. Click ‘Add another field’ to map more of your form fields with Cliniko patient fields. The more fields you map, the more information will be filled in the Cliniko patient record if a new one is created or an existing one is updated.
  12. Once done, Save your form using the Save button in the top right.

Once you’ve completed the above steps, your form responses will start to automatically sync with Cliniko.
Feel free to go ahead and give it a go!


TIP: Ensuring your form responses sync with the right Cliniko Patient record

Minimum requirements:
As long as you have mapped the ‘First Name’ and ‘Last Name’ fields from Cliniko to the fields on your form, our system should be able to automatically check whether the relevant Cliniko Patient exists or create a new one for you each time you receive a form response.
We will also be able to send a PDF copy of the entire form response in to the Patient file.

If your form also contains any or all of the following fields and you have them mapped, it will increase accuracy and help distinguish between Patients who might have the same name. These are not mandatory but good to have:

  • Phone Number
  • Date of Birth
  • Email Address


TIP: Populating all the relevant fields when new Cliniko Patient records are created

The minimum required information for creating a new Cliniko Patient record is the First Name and Last Name. Everything else is optional.
If you have ‘Send PDF copy of form responses to Cliniko’ ticked, you’ll always get a full PDF copy of the whole form response sent to the Patient file in Cliniko.

If your form contains any of these fields, and you have them mapped to Cliniko fields, they will also get populated with information for the new Patient record:

  • Phone Number
  • Date of Birth
  • Email Address
  • Notes
  • Address
  • City
  • State
  • Postcode
  • Country
  • Accepted Privacy Policy
  • Accepted SMS Marketing
  • Emergency Contact
  • Gender
  • Gender Identity
  • Medicare
  • Medicare Reference Number
  • Appointment Notes
  • Occupation
  • Referral Source Type
  • Referral Source Notes
  • Title


TIP: Populating the Referral fields in the Cliniko patient file

To populate the referral field you need to map a one of your form fields to the ‘Referral Source Type’ field in Cliniko.
We recommend using a drop down or choice field on your form. The only acceptable answers for this are:

  • Contact
  • Google
  • Other
  • Patient
  • Website

You can optionally also map an additional form field to the ‘Referral Source Notes’ field in Cliniko. This can be used to obtain more information about the referral.
If the person chooses ‘Other’, you must show an extra text field asking for specifics about the referral and map this field to the ‘Referral Source Notes’ field in Cliniko.


TIP: Populating two form fields in to one Cliniko patient field

There may be a situation where you need to populate two form fields in to a single field in Cliniko, for example in the ‘Notes’ field.
To do this you can simply map two different form fields to the same Cliniko field. Map them in the order you want them to appear in the Cliniko field. Example below:


If you have any issues please feel free to get in touch with us for support.


TIP: Use logs to troubleshoot the integration

If you’re unsure whether your integration is working correctly you can check the integration logs for any form response.
To find these please follow the below steps:

1. Click Forms in the left-hand navigation menu, then next to any of your forms click Actions -> View Responses.
2. Next to any of your form responses click View/Download.
3. Scroll to the bottom of the response details to see the integration logs if there are any integrations enabled.

If you have any issues please feel free to get in touch with us for support.
Get an online form trial or demo absolutely free.