> 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-troubleshooting.md).

# Zoom Troubleshooting

Most Zoom problems fall into two groups: the connection needs attention, or Zoom couldn't create a specific meeting. This page covers both.

## Check the Zoom Card First

Go to **Admin → Coaching → Availability** and look at the **Zoom** card.

| What it says         | What it means                                          | What to do               |
| -------------------- | ------------------------------------------------------ | ------------------------ |
| **Connected**        | Everything is working                                  | Nothing needed           |
| **Not connected**    | No Zoom account is linked                              | Click **Connect Zoom**   |
| **Reconnect needed** | The connection exists but Zoom won't accept it anymore | Click **Reconnect Zoom** |

Reconnecting fixes nearly every connection problem. It takes a few seconds and doesn't affect sessions that are already booked.

## Connection Statuses and Errors

When a session can't use Zoom, you'll see a short explanation. Here's what each one means.

| Message                                                                                | What happened                                                                                                 | What to do                                                                 |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| "Zoom is not connected. Connect your Zoom account and try again."                      | No Zoom account is linked for this community                                                                  | Connect Zoom from the Zoom card                                            |
| "Your Zoom connection was revoked. Reconnect Zoom and try again."                      | Access was removed — either you disconnected, or it was revoked from Zoom's side                              | Reconnect Zoom                                                             |
| "Your Zoom connection has expired. Reconnect Zoom and try again."                      | The connection stopped being valid                                                                            | Reconnect Zoom                                                             |
| "Your Zoom connection is missing a required permission. Reconnect Zoom and try again." | Zoom didn't grant everything the integration needs                                                            | Reconnect Zoom and approve all permissions                                 |
| "Zoom returned an error while setting up the meeting. Please try again."               | Zoom accepted the connection but failed the request — often temporary, sometimes a limit on your Zoom account | Try **Retry** first. If it keeps failing, check your Zoom account's limits |

> **Tip:** If two different sessions fail with the same message on the same day, reconnect Zoom once and retest. It's faster than retrying each session.

## Meeting Statuses

Each Zoom meeting on a session has a status:

| Status        | Meaning                                                     |
| ------------- | ----------------------------------------------------------- |
| **Pending**   | Being created — usually resolves within a minute            |
| **Active**    | Ready; the participant link works                           |
| **Failed**    | Couldn't be created — the session is using your backup link |
| **Cancelled** | The session was cancelled                                   |
| **Replaced**  | A newer meeting replaced this one                           |

**Pending** is normal right after a session is booked. If a session still says Pending after a few minutes, open it again — the app catches up on its own.

## Generate, Retry, and Regenerate

These three actions look similar but do different things.

**Generate Zoom meeting** — creates a meeting for a session that doesn't have one. Use it when the automatic switch is off, or for a session booked before you connected Zoom.

**Retry Zoom setup** — tries again after a failure. Use it when the reason was temporary.

**Regenerate Zoom meeting** — throws the current meeting away and creates a new one.

> **CRITICAL:** Regenerating **breaks the link clients already have**. Only regenerate when the old meeting is unusable, and tell clients to use the new link.

## The Session Fell Back to Your Backup Link

When Zoom fails, the session automatically uses your backup meeting link. That's by design: clients always have somewhere to go.

What you'll see:

* The meeting panel shows **Backup link** as the source
* The Zoom area shows the error
* You receive an email about the failure

Clients are told to use the backup link, so the session can go ahead. Fix the Zoom issue afterwards, then retry or regenerate for future sessions.

## Clients Can't Join

If the session is hosted on Zoom and the client can't get in:

1. **Is the join button enabled?** It unlocks 15 minutes before the start and closes 1 hour after the end
2. **Is the session cancelled or moved?** A cancelled session can't be joined
3. **Did you regenerate the meeting?** The old link stops working
4. **Is the client signed in to Zoom as someone else?** Zoom may refuse or route them to the wrong account
5. **Are they on a phone without the Zoom app?** The link should still open in a browser

## Waiting Room Problems

If clients say they're stuck waiting to be let in, the likely cause is a **personal meeting link** (a link containing `/my/`), which uses Zoom's waiting room.

Two fixes:

* Let the session use an automatically created Zoom meeting instead — scheduled meetings don't use the waiting room
* Or change your waiting-room setting in Zoom so participants join directly

The Availability settings warn you when your backup link looks like a personal link.

## Sessions That Never Get a Meeting

A few session types are skipped on purpose:

* **Waiting for payment** — cancelled automatically if payment doesn't complete
* **Cancelled** — nothing to host
* **Completed** — already finished
* **Sessions where you turned automatic meetings off** — create one manually if needed

## Still Stuck?

Before contacting support, collect:

* The session's date and time
* The exact message shown
* Whether **Connected** or **Reconnect needed** appears on the Zoom card
* Whether reconnecting Zoom changed anything

That's usually enough to pin down the cause in one reply.

## Next Steps

* [Zoom integration](https://digital-builders.gitbook.io/docs/integrations/zoom.md)
* [Joining a session](https://digital-builders.gitbook.io/docs/coaching/joining-a-session.md)
* [Get support](https://digital-builders.gitbook.io/docs/admin/support.md)
