> For the complete documentation index, see [llms.txt](https://digital-builders.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digital-builders.gitbook.io/docs/integrations/zoom.md).

# Zoom Integration

Connect your Zoom account once and Digital Builders hosts your coaching sessions there. Each booked session gets its own Zoom meeting, created for you — with the right time, the right link, and no copy-pasting.

The best part is what happens when things change: a reschedule moves the Zoom meeting, a cancellation cancels it, and clients always get a working link.

## What the Integration Does

* **Creates a Zoom meeting for each confirmed session**, hosted on your Zoom account
* **Puts the participant link on the session** so clients can join from the app or from their confirmation email
* **Updates the meeting when a session is rescheduled**, and cancels it when a session is cancelled
* **Keeps your backup meeting link as a fallback** — if Zoom ever fails, clients still get a link
* **Never exposes your host link to clients.** Only you see "Start meeting"

## Before You Start

* You need to be able to manage coaching in the community (**Admin → Coaching**)
* You need an active Zoom account
* Sessions must be hosted on Zoom by you, the coach — each coach connects their own account

> **Note:** Your Zoom connection applies to the community you connected it in. If you coach in more than one community, connect Zoom in each one.

## Connect Your Zoom Account

1. Go to **Admin → Coaching**
2. Open the **Availability** tab
3. Find the **Zoom** card, next to your backup meeting link
4. Click **Connect Zoom**
5. Sign in to Zoom and approve access
6. You'll be sent back to the app and see **Zoom connected**

The card then shows which Zoom account is connected. That's your confirmation that the right account is linked — important if you have more than one.

> **Tip:** Connect Zoom before you publish your coach page. New sessions booked in the meantime won't have a Zoom meeting, so you'd have to create them by hand.

## Automatic Meetings for New Sessions

The Zoom card has a switch: **"Create a Zoom meeting automatically for new sessions."** It's on by default.

* **On** — every new confirmed session gets its own Zoom meeting, automatically
* **Off** — new sessions don't get one, and you can create meetings yourself on a session-by-session basis

Turn it off if you'd rather decide case by case, for example when only some sessions need a real meeting.

## What Gets a Meeting, and What Doesn't

A Zoom meeting is created when a session is **confirmed** — booked and paid for, or booked free.

These sessions don't get one:

* **Sessions waiting for payment** — a meeting would be wasted on a booking that may expire
* **Cancelled sessions** — nothing to host
* **Completed sessions** — the call is over
* **Sessions where you've turned automatic meetings off**, unless you create one yourself

## Where You See It

Open any session as a coach and you'll see the meeting panel with:

* The **participant link** and where it comes from — **Zoom**, **Backup link**, or **No link**
* Your **backup link**, for reference
* The **Zoom status**, and an explanation if something went wrong
* **Start meeting** — your host link
* A separate **Open coaching room** button when the built-in room is available

> **CRITICAL:** **Start meeting** is for you only. Never share it — it lets the holder start the meeting as the host and take control. Everything the client needs is in the participant link.

## When a Session Changes

**Rescheduled** — the Zoom meeting moves to the new time. Clients keep their existing link, so an old calendar invite might show the previous time even though the meeting itself moved. Remind clients to check the session in the app.

**Cancelled** — the Zoom meeting is cancelled too.

**Regenerated** — if you choose to regenerate a meeting, the old link stops working and clients must use the new one.

## If Something Goes Wrong

Zoom can fail for reasons outside anyone's control: a revoked permission, an expired connection, a rate limit on Zoom's side.

When that happens:

1. The session **falls back to your backup meeting link** — the client is never left without a link
2. You get an **email telling you what failed**
3. The session shows a Zoom error, with **Retry** or **Regenerate** depending on the situation

See [Zoom troubleshooting](https://digital-builders.gitbook.io/docs/integrations/zoom-troubleshooting.md) for what each message means and what to do.

## Disconnecting Zoom

From the Zoom card, click **Disconnect**.

* Access is revoked at Zoom as well as here
* Meetings you've already created stay in your Zoom account — nothing is deleted
* New sessions stop getting automatic meetings until you reconnect
* Your backup link keeps working, so bookings continue

## Privacy and Security

* **No Zoom password** is ever entered into Digital Builders — you sign in on Zoom's own page
* **Access tokens are stored encrypted** and are never shown, in the app or by any screen
* **Clients never see your host link** — only the participant link for the session
* **Disconnecting revokes access**, so nothing continues in the background after you leave

## Common Questions

**Do I need a paid Zoom plan?** No. The integration works with your Zoom account as it is. Any meeting limits come from your Zoom plan, not from Digital Builders.

**Does this use my Zoom waiting room?** Meetings created for sessions are scheduled meetings, so clients join directly. Your waiting-room setting applies to your personal meeting link, not these.

**Can I still use my own link?** Yes. Keep a backup link set — it's your safety net if Zoom is unavailable, and it's used for sessions where you've turned automatic meetings off.

**What if I coach in two communities?** Connect Zoom once in each community.

## Next Steps

* [Zoom troubleshooting](https://digital-builders.gitbook.io/docs/integrations/zoom-troubleshooting.md)
* [Set your availability](https://digital-builders.gitbook.io/docs/coaching/availability.md)
* [Joining a session](https://digital-builders.gitbook.io/docs/coaching/joining-a-session.md)
