​

Cliniko Integration Setup Guide

​

TL;DR - Quick Setup

You need a Cliniko API key — see Generate a Cliniko API Key. 4 Required Settings in Cliniko:

1. Business - Enable “Show in Online Bookings”
2. Practitioner(s) - Enable “Show in Online Bookings”
3. Appointment Type(s) - Enable “Show in Online Bookings”
4. Daily Availabilities - Configure working hours for each practitioner

Quick Steps:

1. Generate an API key in Cliniko
2. Copy the full API key (includes region suffix like -au1 or -eu1)
3. In Cliniko: Enable online bookings for Business, Practitioners, and Appointment Types
4. Intavia → Integrations → Cliniko → Paste API key → Connect

---

​

Why These Settings Matter

The Cliniko API only returns available appointment slots when all four conditions are met:

• Business has online bookings enabled
• Practitioner has online bookings enabled
• Appointment type has online bookings enabled
• Practitioner has daily availabilities configured

If any one is missing, the API returns no availability (404 error).

---

​

Step-by-Step Instructions

​

1. Generate API Key

Follow Cliniko’s official guide: Generate a Cliniko API Key

Important: Copy the entire key including the region suffix (e.g., ABC123...-au1). The suffix (like -au1, -eu1, -uk1) tells Intavia which Cliniko data center your account is on — don’t remove it.

​

2. Enable Online Bookings for Business

1. Settings → Business information (under “Our clinic” section)
2. You’ll see your business listed (e.g., “Intavia”)
3. Click “Edit information” button
4. Scroll down to find “Display this business in online bookings”
5. Toggle it to On ✅
6. Click “Update business” to save

​

3. Enable Online Bookings for Practitioners

1. Settings → Users (left sidebar)
2. Click on each practitioner name
3. In the Online Bookings section, enable “Show in Online Bookings” ✅
4. Save

Repeat for each practitioner who should be bookable via the AI agent.

​

4. Enable Online Bookings for Appointment Types

1. Settings → Appointment Types (left sidebar)
2. Click on each appointment type
3. Enable “Show in Online Bookings” ✅
4. Save

Repeat for each appointment type that should be available for booking.

​

5. Configure Daily Availabilities

1. Go to Appointments (calendar view)
2. Click Availability in the left sidebar
3. Click Adjust schedule
4. For each practitioner:
   • Set working hours for each day of the week
   • Example: Monday-Friday, 9:00 AM - 5:00 PM
5. Save

Important: Without daily availabilities, the API has no time slots to offer even if everything else is enabled.

​

6. Assign Appointment Types to Practitioners

1. Settings → Appointment Types
2. Click on an appointment type
3. Scroll to Practitioners section
4. Check the practitioners who can provide this appointment type
5. Save

​

7. Connect in Intavia

1. Intavia → Integrations → Cliniko → Connect
2. Paste your API key (the full key including the -region suffix)
3. Click Connect

Done! Your agent can now handle appointments via Cliniko.

---

​

What Can Intavia Access?

With this integration, Intavia can:

• ✅ View businesses/locations
• ✅ View practitioners and their availability
• ✅ View appointment types
• ✅ Search for patients
• ✅ Book/reschedule/cancel appointments
• ✅ View patient appointments

Intavia CANNOT:

• ❌ Delete patients
• ❌ Access financial/billing data
• ❌ Access treatment notes
• ❌ Modify practice settings

---

​

Troubleshooting

​

”Invalid API key format” error

Your API key is missing the region suffix. Fix: Generate a new API key from Cliniko. The full key should end with something like -au1, -eu1, -uk1, -us1, or -ca1.

​

”Could not validate credentials” error

The API key is incorrect or has been revoked. Fix:

1. In Cliniko, go to My Info → API Keys
2. Delete the old key
3. Generate a new one
4. Copy the entire key and paste it in Intavia

​

No availability showing (all slots empty)

This means one or more online booking requirements aren’t met. Checklist:

• Business has “Show in Online Bookings” enabled
• Practitioner has “Show in Online Bookings” enabled
• Appointment type has “Show in Online Bookings” enabled
• Daily availabilities are configured for the practitioner
• Appointment type is assigned to the practitioner

​

”Could not connect to Cliniko” error

Network issue or Cliniko is down. Fix: Wait a few minutes and try again. Check Cliniko Status for outages.

---

​

Cliniko Regions

Your Cliniko URL tells you which region you’re on: The API key automatically includes your region (e.g., -eu1), so you don’t need to select it manually.

---

​

Security

• Never share your API key publicly
• Revoke unused keys in Cliniko → My Info → API Keys
• Rotate periodically (every 6-12 months recommended)

To rotate: Generate new key in Cliniko → Update in Intavia → Delete old key in Cliniko

---

​

References

• Cliniko API Documentation
• Generate a Cliniko API Key
• Cliniko Status Page

---

Last Updated: December 2025