Get Started Get Started

Setup the Cliniko Integration

The Cliniko integration brings your Cliniko patients and appointments into Oncord, so you can send targeted email and SMS campaigns and trigger automated workflows based on appointments. It is for practices that manage their patients and appointments in Cliniko. This guide covers connecting Cliniko, choosing how contacts sync and adding Cliniko online bookings to your website.

In this article:

Before You Begin

  • The Cliniko integration is free.
  • To send email or SMS campaigns to your synced patients, enable Oncord's Marketing feature. If it is enabled, Marketing appears in the left sidebar of your Oncord dashboard. Manage your features under Dashboard > Settings > Features (see Changing Your Oncord Plan).
  • You need to be able to log in to Cliniko to generate an API key.

What Data Is Synchronised?

From Oncord From Cliniko
Contacts
  • Whether changes to a contact are sent to Cliniko depends on your contact sync mode. By default, Oncord links contacts to their existing Cliniko patient record but never changes anything in Cliniko.
  • Deleting a contact doesn't delete the patient in Cliniko.
  • Creating a contact doesn't create a patient in Cliniko. This keeps subscribers and other contacts out of your Cliniko patient list.
Patients
  • All patients in Cliniko are pulled into Oncord.
  • Changes to a patient are reflected in Oncord. In Two-way mode, the most recently updated record wins.
  • Deleting a patient doesn't remove the contact from Oncord.
Appointments
  • You can embed the Cliniko online booking calendar in your Oncord website, so contacts can book appointments.
  • Alternatively, you can add a Book Now button to your website that links to your online booking calendar.
Appointments
  • Appointments are pulled into Oncord and appear in the contact's activity feed.

Deletions are not reflected in either system, so you may need to delete entries in both.

Contact Fields Synchronised

When a contact is linked to a Cliniko patient, a blue Cliniko logo appears on the contact. Click it to view their patient record in Cliniko.

When Oncord is allowed to update Cliniko (Two-way mode), only the fields changed in Oncord are updated on the patient record, and only for contacts already linked to a Cliniko patient.

These contact fields are synchronised:

  • First name and last name
  • Address, suburb, postcode, state and country
  • Email address
  • Phone numbers
  • Email marketing consent and SMS opt-out status (managed separately, see Cliniko Email and SMS Marketing Preferences below)
  • Date of birth
  • Gender

Appointments Synchronised

Appointment data is pulled into Oncord and appears in the contact's activity feed. This appointment data is synchronised:

  • Appointment start and end times
  • Appointment type
  • Whether the patient arrived at the appointment
  • Whether the patient cancelled the appointment
  • The practitioner

Connect Cliniko

  • In Cliniko, generate an API key. Cliniko's guide Generate a Cliniko API key shows how.
  • In Oncord, go to Dashboard > Settings > Third Party Integrations.
  • In the Cliniko box, click Enable. The Connect Cliniko dialog opens.
  • Paste your key into Paste Your API Key.
  • Click Connect to Cliniko. Oncord confirms the connection and returns you to the Third Party Integrations page.

To use a different API key later, click Configuration in the Cliniko box, then Change API Key.

Choose a Contact Sync Mode

The Contact Sync setting on the Cliniko configuration page controls which system is allowed to update contact details. Patients and appointments are always pulled from Cliniko into Oncord, and Oncord never creates or deletes Cliniko patients in any mode.

  • Cliniko preferred (recommended, and the default) - Cliniko is the source of truth. Oncord links a contact to an existing Cliniko patient when exactly one patient has the same first name, last name and email address, but never changes patient records in Cliniko. Patient details from Cliniko always overwrite the linked Oncord contact.
  • Two-way updates - Changes made in either system are sent to the other. When both have changed, the most recently updated record wins. Oncord only updates patients that are already linked to a contact.
  • Cliniko to Oncord only - Oncord never looks up or updates patients in Cliniko. Cliniko patients and appointments still flow into Oncord.

To change the mode:

  • Go to Dashboard > Settings > Third Party Integrations.
  • In the Cliniko box, click Configuration.
  • Under Contact Sync, choose a mode.
  • Click Save Configuration.

Note: Changing the mode discards any contact changes still waiting to be sent to Cliniko, so the new rule applies from the next sync onwards.

When Does a Sync Happen?

Automatic sync is off until you turn it on:

  • In the Cliniko box, click Configuration.
  • Set Auto-Sync to Enabled.
  • Click Save Configuration.

With Auto-Sync enabled, changes in Oncord normally queue a sync with Cliniko about two minutes later. Timing can vary, and a sync already queued for an earlier time is not delayed by later changes. When there are no changes in Oncord, background sync checks Cliniko approximately every 15 minutes.

You can also start a sync at any time:

  • In the Cliniko box, click Synchronise.
  • After the first sync, choose a Sync Type: Modified Since Last Sync or All Records.
  • Click Synchronise.

Automation Triggers

Note: Check each contact's email subscription status and SMS opt-out setting before sending. These are synchronised separately from Cliniko.

Enabling the Cliniko integration adds these automation triggers to Oncord. Each one can be limited to specific appointment types and practitioners.

  • Cliniko - On an upcoming appointment - Triggers a set number of hours, days or weeks before an appointment. This trigger is typically used for appointment reminders, or to send patients important information about their upcoming appointment.
  • Cliniko - When a contact cancels their appointment - Triggers when a contact cancels their appointment.
  • Cliniko - When a contact did not arrive to an appointment - Triggers when a contact does not arrive at their appointment.
  • Cliniko - When a contact finishes their appointment - Triggers when a contact finishes their appointment.
  • Cliniko - When an appointment is created - Triggers at the time an appointment is created.

When will automations start to trigger for appointments?

Automations trigger only for appointment activity that happens after your Oncord account goes live and the Cliniko integration is enabled and syncing.

Appointment Types Reflected in Oncord Automations

Oncord needs to sync at least one appointment of a type before that type appears as a setting for automation triggers. If you have created a new appointment type in Cliniko and it hasn't appeared in Oncord yet:

  • Create a test appointment of that type in Cliniko.
  • In Oncord, go to Dashboard > Settings > Third Party Integrations.
  • In the Cliniko box, click Synchronise and run a sync.

The new appointment type then appears in the Automations area.

Marketing Send Conditions

When you send an email or SMS campaign, you can target it with the Cliniko - Has Appointment condition, based on:

  • When the appointment is booked (Timeframe)
  • The Appointment type
  • The Practitioner

Note: Check each contact's email subscription status and SMS opt-out setting before sending. These are synchronised separately from Cliniko.

Cliniko Email and SMS Marketing Preferences

Oncord imports email marketing consent and SMS preferences separately. Accepting email marketing in Cliniko updates the contact's email subscription status in Oncord, and the SMS preference updates their SMS opt-out setting.

Keep these preferences consistent with each patient's choices. Don't enable both channels for everyone just to make them eligible for a campaign.

After updating a patient's preferences in Cliniko, run a manual sync with Synchronise in the Cliniko box, then check the contact's email and SMS settings in Oncord.

Add Online Bookings to Your Website

Cliniko's online booking calendar helps you take bookings through your website at any time, which reduces the time spent taking bookings over the phone.

Before adding the calendar to your website, follow Cliniko's instructions to configure and enable your online bookings page: Cliniko: Set Up Online Bookings.

There are two ways to add a booking option to your Oncord website:

  • Booking URL - Use your booking URL as a text link or Book Now button on a page of your website. Visitors leave your website to make an appointment in your Cliniko online bookings calendar.
  • Embed Code - Add the embed code to a page of your Oncord website to show your Cliniko online bookings calendar on the page. The steps are below.

Embed Your Cliniko Online Bookings Calendar

In Cliniko:

  • Go to Settings.
  • Under Appointments, click Online bookings.
  • Find Code to embed in your website and copy the code.

In Oncord (these steps are shown in the video below):

  • Create a new Book Now page, if you don't have one yet (see Creating a New Page).
  • Go to Dashboard > Website > Pages and click the page to edit it.
  • Click Insert on the left of the editor.
  • Drag the Embed element onto the page.
  • Select the Embed element and click Edit on its toolbar.
  • In the panel on the left, paste the embed code from Cliniko.
  • Click Save to save the page.

Disconnect Cliniko

  • Go to Dashboard > Settings > Third Party Integrations.
  • In the Cliniko box, click Remove.
  • Confirm that you want to remove the integration.

Removing the integration deletes its configuration, the appointments synced from Cliniko and the links between contacts and Cliniko patients. Your contacts stay in Oncord. To use Cliniko again, connect it from the start.