> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Cliniko connector

- Connector: `appmixer.cliniko`
- Version: 1.0.2
- Components: 30 (7 triggers, 23 actions)

Cliniko is practice management software for allied health clinics - physiotherapy, chiropractic, massage, podiatry and psychology. Manage patients, appointments, treatment notes, invoices and contacts, look up available booking times, and react to new or updated records with polling triggers.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2>
- Documentation: <https://docs.appmixer.com/connector-configuration/cliniko>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/cliniko>
- Download package: <https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/download>

## Authentication

**Type:** API Key

**Fields:**

- `API Key` (password): In Cliniko go to _My Info &rarr; Manage API keys &rarr; Create API key_, then paste the key here. The key is sent as the HTTP Basic username with an empty password. The region (shard) is read from the key itself, so no extra field is needed.

## Triggers (7)

- [Cancelled Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CancelledAppointment.md) (`appmixer.cliniko.core.CancelledAppointment`): Triggers when an individual appointment is cancelled. Cancelled appointments are normally hidden from the API; this trigger asks for them explicitly and polls the "cancelled at" timestamp. The first run only records a baseline.
- [New Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.NewAppointment.md) (`appmixer.cliniko.core.NewAppointment`): Triggers when a new individual appointment is booked. Optionally narrow it to one practitioner or business. The first run only records a baseline and emits nothing.
- [New Booking](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.NewBooking.md) (`appmixer.cliniko.core.NewBooking`): Triggers when a new booking appears in the calendar. Bookings cover individual and group appointments as well as unavailable blocks, which makes this the trigger to use for patient-made online bookings. The first run only records a baseline.
- [New Invoice](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.NewInvoice.md) (`appmixer.cliniko.core.NewInvoice`): Triggers when a new invoice is created. The first run only records a baseline and emits nothing.
- [New Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.NewPatient.md) (`appmixer.cliniko.core.NewPatient`): Triggers when a new patient is created in Cliniko. Cliniko has no webhooks, so this polls the patient list on the account's tick interval and emits patients created since the previous run. The first run only records a baseline and emits nothing.
- [Updated Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.UpdatedAppointment.md) (`appmixer.cliniko.core.UpdatedAppointment`): Triggers when an individual appointment is changed - rescheduled, annotated or marked as arrived. Polling is based on the "updated at" timestamp, so a newly booked appointment fires this trigger too. The first run only records a baseline.
- [Updated Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.UpdatedPatient.md) (`appmixer.cliniko.core.UpdatedPatient`): Triggers when a patient record is changed. Polling is based on the patient's "updated at" timestamp, so a newly created patient fires this trigger too. The first run only records a baseline and emits nothing.

## Actions (23)

- [Archive Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.ArchivePatient.md) (`appmixer.cliniko.core.ArchivePatient`): Archives a patient. Archived patients are hidden from Cliniko and excluded from searches, but nothing is destroyed - use Unarchive Patient to bring them back. Returns an empty object.
- [Cancel Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CancelAppointment.md) (`appmixer.cliniko.core.CancelAppointment`): Cancels an individual appointment, keeping it on record with a cancellation reason. This is not a deletion - the appointment stays in Cliniko and reporting. Returns an empty object.
- [Create Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CreateAppointment.md) (`appmixer.cliniko.core.CreateAppointment`): Books a new individual (one-on-one) appointment. End time is derived from the appointment type duration unless you set it explicitly.
- [Create Contact](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CreateContact.md) (`appmixer.cliniko.core.CreateContact`): Creates a contact - a referring doctor, a third-party payer or any other non-patient contact. Cliniko requires a First Name or a Last Name even for a company contact.
- [Create Medical Alert](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CreateMedicalAlert.md) (`appmixer.cliniko.core.CreateMedicalAlert`): Adds a medical alert to a patient. Alerts are shown prominently on the patient record in Cliniko.
- [Create Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CreatePatient.md) (`appmixer.cliniko.core.CreatePatient`): Creates a new patient. Last Name is the only field Cliniko requires.
- [Create Treatment Note](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.CreateTreatmentNote.md) (`appmixer.cliniko.core.CreateTreatmentNote`): Creates a treatment note for a patient. Cliniko stores note bodies as a structured sections object, so Content takes JSON in the shape `{"sections":[{"name":"Subjective","questions":[{"name":"Complaint","type":"text","answer":"..."}]}]}`. Copy the shape from an existing note (Find Treatment Notes) or from the treatment note template.
- [Find Appointments](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.FindAppointments.md) (`appmixer.cliniko.core.FindAppointments`): Searches individual (one-on-one) appointments by date range, patient, practitioner or business. Returns up to 100 appointments (one page at the maximum page size).
- [Find Available Times](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.FindAvailableTimes.md) (`appmixer.cliniko.core.FindAvailableTimes`): Finds the bookable appointment start times for a practitioner at a business, for a given appointment type, within a date window. The business, practitioner and appointment type must all be enabled for online bookings in Cliniko - otherwise the endpoint answers 404. Cliniko allows a window of at most 7 days and will not look into the past.
- [Find Contacts](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.FindContacts.md) (`appmixer.cliniko.core.FindContacts`): Searches contacts (referring doctors, third-party payers and other non-patient contacts) by name, company or email. Name, company and email filters are "contains" matches. Returns up to 100 contacts (one page at the maximum page size).
- [Find Invoices](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.FindInvoices.md) (`appmixer.cliniko.core.FindInvoices`): Searches invoices by patient, practitioner, business, status or issue date. Returns up to 100 invoices (one page at the maximum page size).
- [Find Patients](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.FindPatients.md) (`appmixer.cliniko.core.FindPatients`): Searches patients by name, email or date of birth. Name and email filters are "contains" matches. Returns up to 100 patients (one page at the maximum page size).
- [Find Treatment Notes](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.FindTreatmentNotes.md) (`appmixer.cliniko.core.FindTreatmentNotes`): Searches treatment notes by patient, practitioner or draft status. Returns up to 100 treatment notes (one page at the maximum page size). Note that the API key inherits the permissions of its Cliniko user - a user without clinical access gets a 403 here.
- [Get Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.GetAppointment.md) (`appmixer.cliniko.core.GetAppointment`): Retrieves a single individual appointment by ID.
- [Get Next Available Time](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.GetNextAvailableTime.md) (`appmixer.cliniko.core.GetNextAvailableTime`): Returns the single next bookable appointment start time for a practitioner at a business, for a given appointment type. The business, practitioner and appointment type must all be enabled for online bookings in Cliniko - otherwise the endpoint answers 404. Cliniko allows a window of at most 7 days and will not look into the past.
- [Get Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.GetPatient.md) (`appmixer.cliniko.core.GetPatient`): Retrieves a single patient by ID.
- [List Appointment Types](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.ListAppointmentTypes.md) (`appmixer.cliniko.core.ListAppointmentTypes`): Lists the appointment types configured in the Cliniko account. Returns up to 100 appointment types (one page at the maximum page size).
- [List Businesses](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.ListBusinesses.md) (`appmixer.cliniko.core.ListBusinesses`): Lists the businesses (clinic locations) in the Cliniko account. Returns up to 100 businesses (one page at the maximum page size).
- [List Practitioners](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.ListPractitioners.md) (`appmixer.cliniko.core.ListPractitioners`): Lists the practitioners in the Cliniko account. Returns up to 100 practitioners (one page at the maximum page size).
- [Make API Call](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.MakeApiCall.md) (`appmixer.cliniko.core.MakeApiCall`): Performs an arbitrary authorized call against the Cliniko API. The path is resolved against the base URL derived from your API key's shard, so a path such as `/patients` is enough.
- [Unarchive Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.UnarchivePatient.md) (`appmixer.cliniko.core.UnarchivePatient`): Restores a previously archived patient. Returns an empty object.
- [Update Appointment](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.UpdateAppointment.md) (`appmixer.cliniko.core.UpdateAppointment`): Reschedules or edits an existing individual appointment. Only the fields you fill in are sent. To cancel an appointment use Cancel Appointment instead. Returns an empty object.
- [Update Patient](https://connectors.appmixer.com/connector/appmixer.cliniko/1.0.2/component/appmixer.cliniko.core.UpdatePatient.md) (`appmixer.cliniko.core.UpdatePatient`): Updates an existing patient. Only the fields you fill in are sent - everything else is left untouched. Returns an empty object.

## Changelog

### 1.0.2

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.0.1

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.0.0

- Initial release.
