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

# Calendar Sync

> Connect your Google or Microsoft calendar so RxScale appointments appear there — and so your existing commitments block bookable slots

# Calendar Sync

Connect your personal **Google** or **Microsoft (Outlook)** calendar and RxScale will
automatically add your scheduled appointments to it — so your bookings live alongside
the rest of your day. Sync runs in **both directions**: RxScale also reads when you are
already busy, so patients cannot book a slot that clashes with something already in your
calendar.

<Note>
  **Your patients' data stays limited.** A synced event contains a generic title
  (*"RxScale consultation"*), the appointment time, a link to your **Meetings** page
  in the Doctor Portal, and the patient-provided visit reason when one was supplied.
  Patient names and order information are not written to your external calendar.
</Note>

<Note>
  **What RxScale reads from your calendar.** To block clashing slots, RxScale reads the
  calendars you **own or can edit** (calendars merely shared with you, and subscribed
  calendars such as holidays, are skipped). It stores only the **start and end time** of
  each busy period, for the next **60 days** — never event titles, descriptions,
  locations, attendees or organisers. Those times are used solely to hide slots you are
  not free for, and are deleted as soon as you disconnect the calendar.
</Note>

## Connecting a calendar

1. Open the **Meetings → Availability** page in the Doctor Portal.
2. In the **Calendars** section, click **Connect** next to Google or Microsoft.
3. Sign in to your calendar provider and grant access when prompted.
4. You are returned to RxScale; the calendar now shows as **Connected**.

<Note>
  **Where Google appointments appear.** For Google, RxScale creates a dedicated
  calendar called **"RxScale Appointments"** in your account and adds your bookings
  there (rather than to your primary calendar). It still shows alongside your other
  events in Google Calendar, and you can hide or recolour it like any other calendar.
  Microsoft (Outlook) appointments are added to your primary calendar.
</Note>

After connecting, use **Sync meetings** on the calendar to add your existing
upcoming confirmed appointments. New bookings are added automatically from then on;
this button is only needed to backfill appointments confirmed before you connected.
You can press it again any time — it never duplicates events.

You can connect **both** a Google and a Microsoft calendar at the same time — each
appointment is added to every connected calendar.

## What gets synced

| When                            | What happens on your calendar      |
| ------------------------------- | ---------------------------------- |
| An appointment is **confirmed** | A new event is created             |
| An appointment is **rebooked**  | The event is moved to the new time |
| An appointment is **cancelled** | The event is removed               |

Only confirmed appointments are synced — pending holds are not.

## How your calendar blocks bookable slots

Anything marked busy in a connected calendar hides the overlapping slots from patients,
so you will not be double-booked. RxScale refreshes this regularly, and checks your
calendar once more at the moment a patient reserves a slot — so a meeting you accept
minutes earlier is still taken into account.

These events **do not** block your slots:

* Invitations you **declined**, and cancelled meetings.
* Events you marked **free** ("Show as free" in Google, *Free* in Outlook).
* **All-day** events and **tentative** / "maybe" invitations — an all-day entry such as a
  conference or a birthday does not close your whole day.
* The RxScale appointments we added ourselves.

If you need an all-day entry to block bookings, add a normal timed event marked *busy*
for the hours you are unavailable, or block the time on your **Availability** page.

<Note>
  **Slots stay bookable up to 60 days ahead**, which is how far RxScale reads your
  calendar. If your calendar shows **Reconnect needed**, RxScale can no longer read it —
  your slots stay open, so reconnect promptly to avoid clashes.
</Note>

<Note>
  **Google connections made before this feature need reconnecting.** Reading your busy
  time needs a read permission that older connections were never asked for. Those show
  **Reconnect needed** — click **Reconnect** and approve the extra permission.
</Note>

## Disconnecting

Click **Disconnect** next to a connected provider. RxScale revokes its access,
removes any **upcoming** RxScale events it created from that calendar (past
appointments are left as a record), deletes the busy times it had stored for you,
and stops syncing. Your slots then depend on your RxScale availability alone.

<Note>
  If a connection shows **Reconnect needed**, your provider's access expired or was
  revoked (for example, you changed your password). Syncing is paused — the
  **Sync meetings** button is hidden, and your calendar no longer blocks slots —
  until you click **Reconnect** to restore access.
</Note>