Connect Cliniko (allied health)

Step-by-step setup. AI agent looks up patients, checks practitioner availability, and books appointments mid-call. 5 minutes from API key to live.

Provider docs

Step 1 — Generate your Cliniko API key

Sign in to Cliniko as the practice owner (only owners can create API keys).
Click your name (top-right) → My info.
Scroll to the bottom → Manage API keys → Generate new key.
Give it a label like 'VoxReach AI booking'.
Copy the key. It looks like a long string ending in '-au1' (or '-au2', '-uk1', '-us1' depending on your data centre).

In VoxReach: Integrations → Cliniko → Connect.
Paste your Cliniko API key into the single field.
Click Connect. We immediately call /v1/businesses to test — should return ✓ within 2 seconds.
Booking tools auto-attach to every AI agent in your tenant within 5 seconds.

On the Cliniko integration page, scroll down to 'Booking workflow'.
Tick 'Use this as the default booking provider'. (Required so the AI knows which platform to book into when a tenant has multiple connected.)
Default appointment duration: pick what most of your appointments are (30 or 60 min).
Max days ahead: how far in the future the AI is allowed to book (default 60 days).
Tick 'Send confirmation SMS to caller' and 'Notify staff member by SMS' — both ON by default.
Customise the SMS templates if you want (placeholders: {tenantName} {when} {withStaff} {jobRef}).

Add a test patient in Cliniko with your own mobile number.
Ring your VoxReach number from that mobile.
The AI should greet you by name (matched from Cliniko via phone).
Ask to book a standard initial consultation for tomorrow afternoon.
AI checks practitioner availability live, offers slots.
Pick one — it should appear in your Cliniko diary within seconds with a note 'Booked via VoxReach AI'.

401 invalid key — regenerate the key in Cliniko (it might have been revoked) and re-paste.
Patient not matched — Cliniko stores phones in different formats. Confirm the mobile in Cliniko has no spaces or symbols, just digits.
AI says 'no slots available' — check that the practitioner has working hours set in Cliniko AND that your VoxReach business hours match (Branding → Business hours).
Booking creates but no SMS — check your tenant has an SMS-capable number on /numbers and that 'Confirm caller via SMS' is ticked in workflow.