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

# Zoom

> Connect Zoom to create meeting links for Olympus calendar bookings

Zoom connects your host account to Olympus so custom calendars can create, update, and delete Zoom meetings automatically when leads book, reschedule, or cancel appointments.

<Info>
  Zoom is used by the Calendar booking flow. It is not an external calendar sync destination like Google Calendar or Outlook Calendar.
</Info>

## What Zoom powers

Once connected, Olympus can:

* Create a scheduled Zoom meeting when a lead books a calendar slot whose location is **Zoom**
* Store the Zoom join URL on the booking so the lead and host can access it
* Update the meeting time when the booking is rescheduled
* Delete the meeting when the booking is cancelled

## Connect Zoom

<Steps>
  <Step title="Open Integrations">
    Go to **Settings > Integrations** in Olympus.
  </Step>

  <Step title="Click Connect on Zoom">
    Find the **Zoom** card and click **Connect**.
  </Step>

  <Step title="Authorize Olympus in Zoom">
    Sign in to Zoom and approve the requested permissions.
  </Step>

  <Step title="Confirm the connection">
    You are redirected back to Olympus. The Zoom card should show **Connected** with the connected account email.
  </Step>
</Steps>

## Use Zoom in a calendar

<Steps>
  <Step title="Create or edit a custom calendar">
    Go to **Build > Calendars** and open the calendar wizard.
  </Step>

  <Step title="Add a Zoom location">
    In the **Integrations** step, add a location and select **Zoom**.
  </Step>

  <Step title="Save the calendar">
    Olympus verifies that Zoom is connected before allowing a calendar with a Zoom location to save.
  </Step>

  <Step title="Publish or share the booking link">
    When a lead books a Zoom slot, Olympus creates the Zoom meeting under the connected host account and saves the join URL on the booking.
  </Step>
</Steps>

<Warning>
  If Zoom is disconnected or the token expires, bookings that require a Zoom link are blocked with a configuration error instead of creating a booking without a meeting link.
</Warning>

## Booking lifecycle

| Action                        | What Olympus does                                                                                                                                |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Book**                      | Creates a scheduled Zoom meeting after the booking is confirmed, then stores `{ text: joinUrl, zoomMeetingId }` in the booking location details. |
| **Reschedule, still Zoom**    | Updates the existing Zoom meeting time and keeps the same join URL.                                                                              |
| **Reschedule to Zoom**        | Creates a new Zoom meeting and stores its join URL and meeting ID.                                                                               |
| **Reschedule away from Zoom** | Best-effort deletes the old Zoom meeting and replaces the booking location details.                                                              |
| **Cancel**                    | Best-effort deletes the Zoom meeting. The Olympus booking remains cancelled even if Zoom cleanup fails.                                          |

## Calendar sync behavior

Zoom meetings are separate from external calendar event sync:

* Google Calendar and Outlook Calendar event references are stored in `external_events`
* Zoom meeting IDs are stored in `location_details.zoomMeetingId`
* If external calendar sync is enabled, the synced calendar event receives the Zoom join URL as its event location
* Availability checks do not treat Zoom as a calendar provider

## Disconnect Zoom

To disconnect Zoom, go to **Settings > Integrations**, find the Zoom card, and click **Disconnect**.

Disconnecting revokes the stored Zoom token when possible and marks the integration as disconnected in Olympus. Existing bookings remain in Olympus; future Zoom bookings require reconnecting Zoom.

## Permissions

When you connect Zoom, Olympus asks for permission to read your Zoom account identity and manage scheduled meetings for calendar bookings.

Olympus uses those permissions only to create meeting links, update meeting times after reschedules, and remove meetings after cancellations.

## Troubleshooting

| Issue                                       | Resolution                                                                                                                                 |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Calendar cannot be saved with Zoom selected | Connect Zoom in **Settings > Integrations**, then return to the calendar wizard.                                                           |
| Booking says Zoom is disconnected           | Reconnect Zoom in **Settings > Integrations**.                                                                                             |
| Meeting was not deleted after cancellation  | Olympus treats Zoom deletion as best-effort after the booking is already cancelled. Delete the meeting manually in Zoom if cleanup failed. |

## What to do next

Create or update a custom calendar in **Build > Calendars**, then add **Zoom** as a booking location.