> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intavia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PracticeHub setup

> Connect Intavia to PracticeHub and configure PracticeHub so appointment types, practitioners, and availability show up correctly.

# PracticeHub Integration Setup Guide

## TL;DR - Quick Setup

**You need 2 things from PracticeHub:**

1. **Your PracticeHub subdomain** (everything before `.practicehub.io`, e.g. `connectivechiropractic` or `demo.neptune`)
2. **A PracticeHub API key**

**3 required PracticeHub settings so Intavia can see availability:**

1. **Practitioners:** active + enabled for **Online Bookings**
2. **Appointment types:** active + enabled for **Online Bookings** (Web or Patient App) + **not hidden** from patients
3. **Online bookings availability:** configured so PracticeHub returns time slots

**Quick steps:**

1. PracticeHub → Generate an API key
2. PracticeHub → Enable online bookings for the practitioners you want bookable
3. PracticeHub → Enable online bookings for appointment types (and make sure they’re visible)
4. Intavia → Integrations → PracticeHub → Enter subdomain + API key → Connect

***

## Why These Settings Matter

Intavia only uses what PracticeHub exposes as **online-bookable**:

* Practitioners must be marked for online bookings, otherwise they won’t appear in scheduling context.
* Appointment types must be enabled for online bookings (Web or Patient App) and not hidden, otherwise they won’t be offered.
* Availability must be configured in PracticeHub, otherwise the API returns no time slots.

***

## Step-by-Step Instructions

### 1. Find your PracticeHub subdomain

Your subdomain is the part of your PracticeHub URL **before** `.practicehub.io`.

Examples:

* `https://connectivechiropractic.practicehub.io` → subdomain is `connectivechiropractic`
* `https://demo.neptune.practicehub.io` → subdomain is `demo.neptune`

You’ll paste this into Intavia during connection.

### 2. Generate a PracticeHub API key

Follow PracticeHub’s guide to generate an API key:

* [Generate an API key in PracticeHub](https://help.bookedsolid.co.uk/articles/4944120-practicehub#:~:text=Generate%20an%20API%20Key%20in%20PracticeHub\&text=In%20order%20to%20do%20this,Then%20hit%20Generate%20API%20Key.)

Copy the key and store it somewhere safe.

### 3. Enable Online Bookings 2.0 and configure availability

PracticeHub needs to be configured to return bookable time slots.

Follow PracticeHub’s Online Bookings 2.0 setup guide:

* [Setting up Online Bookings 2.0](https://learn.practicehub.io/en/articles/10111283-setting-up-online-bookings-2-0)

### 4. Enable online bookings for practitioners

In PracticeHub, ensure each practitioner you want Intavia to book for:

* Is **active**
* Has **Online Booking** enabled

If a practitioner isn’t enabled for online booking, Intavia won’t include them in booking flows.

### 5. Enable online bookings for appointment types

In PracticeHub, ensure each appointment type you want Intavia to offer:

* Is **active**
* Has Online Bookings enabled for at least one channel:
  * **Web active** (Online bookings site), or
  * **Patient app active**
* Is **not hidden** from patients (`hide from patient` must be off)

If an appointment type is hidden or not enabled for online booking, Intavia won’t show it or use it for availability.

### 6. Connect in Intavia

1. **Intavia** → **Integrations** → **PracticeHub** → **Connect**
2. Enter:
   * **PracticeHub subdomain** (from Step 1)
   * **API key** (from Step 2)
3. Click **Connect**

***

## Troubleshooting

### Connected successfully, but no practitioners appear

Check in PracticeHub:

* Practitioner is **active**
* Practitioner has **Online Booking** enabled

### Connected successfully, but no appointment types appear

Check in PracticeHub:

* Appointment type is **active**
* Appointment type has **Web active** or **Patient app active** enabled
* Appointment type is **not hidden from patients**

### Appointment types appear, but availability is empty

Check in PracticeHub:

* Online Bookings 2.0 is set up and availability is configured to produce time slots
* You can find bookable slots in PracticeHub’s own online booking experience for the same appointment type/location

***

## References

* [Generate an API key in PracticeHub](https://help.bookedsolid.co.uk/articles/4944120-practicehub#:~:text=Generate%20an%20API%20Key%20in%20PracticeHub\&text=In%20order%20to%20do%20this,Then%20hit%20Generate%20API%20Key.)
* [Setting up Online Bookings 2.0](https://learn.practicehub.io/en/articles/10111283-setting-up-online-bookings-2-0)

***

*Last Updated: December 2025*