← BetterBeing
Docs / Integrations / Zoom

Zoom Integration

BetterBeing integrates with Zoom to allow practitioners to launch video sessions, auto-generate meeting links, and synchronize session schedules — all without leaving the platform.

Overview

The BetterBeing Zoom integration enables the following features:

Session launching
Start or join a Zoom meeting for a scheduled session directly from the BetterBeing session view.
Auto-generated meeting links
When you schedule a session, BetterBeing automatically creates a unique Zoom meeting link and attaches it to the appointment.
Calendar sync
Session events are synchronized to your connected calendar with Zoom links included, so both you and your client receive accurate meeting details.

This integration uses Zoom’s official OAuth 2.0 authorization flow. BetterBeing does not access Zoom session content (video, audio, or recordings).

Prerequisites

Before connecting Zoom, ensure you have the following:

  • An active BetterBeing account (Solo, Clinic, or Enterprise plan).
  • A Zoom account — Free, Pro, or Business tier. Meeting creation must be enabled for your Zoom account.
  • A compatible web browser (Chrome, Firefox, Safari, Edge — latest versions recommended).
  • For clinic or enterprise users: integration access must be enabled by your organization administrator.

Getting Started

Follow these steps to connect your Zoom account to BetterBeing:

  1. 1
    Open Integration Settings
    Log in to BetterBeing and navigate to BetterBeing Console → Video Accounts → Zoom.
  2. 2
    Initiate Authorization
    Click "Connect Zoom Account." You will be redirected to Zoom's secure authorization page.
  3. 3
    Grant Permissions
    Review the permissions requested by BetterBeing (see Permissions & Scopes below) and click "Allow" to authorize the integration.
  4. 4
    Confirm Connection
    You will be redirected back to BetterBeing. Your Zoom account will appear as connected in BetterBeing Console → Video Accounts → Zoom.
  5. 5
    Schedule Your First Session
    Create or edit a session in your BetterBeing calendar. A Zoom meeting link will be generated automatically and attached to the session.
Privacy recommendation: BetterBeing creates meetings using your default Zoom account settings. We recommend enabling the Waiting Room in your Zoom web portal to ensure client privacy between sessions — this is considered best practice under PIPEDA and PHIPA guidelines.

Launching Sessions

Once Zoom is connected, you can start a video session in two ways:

From the Calendar

Click on any scheduled session in your BetterBeing calendar. In the session detail view, click Start Zoom Session. This opens the Zoom meeting in your Zoom client or browser.

Your browser may display a prompt asking to “Open Zoom Meetings” — click Allow to launch the Zoom desktop application. If you prefer, you can also join via the browser without installing the app.

From the Session View

Within an active session, the Zoom meeting link is displayed at the top of the session panel. Click the link to launch or copy it to share with your client.

Note: Zoom meeting links are unique per session. Do not reuse meeting links across different clients or sessions.

Calendar Sync

BetterBeing synchronizes session schedules with your connected calendar. When Zoom is enabled:

  • Each scheduled session creates a calendar event with the Zoom meeting link in the event description.
  • Rescheduling a session in BetterBeing updates the corresponding calendar event and generates a new Zoom meeting link.
  • Cancelling a session in BetterBeing removes the calendar event and invalidates the Zoom meeting link.
Tip: Changes made directly in your external calendar are not synced back to BetterBeing. Always manage sessions from BetterBeing to maintain accuracy.

Permissions & Scopes

BetterBeing requests the following OAuth scopes from Zoom. We only request the minimum permissions necessary to provide the integration features.

meeting:write:meeting
Create Zoom meetings when sessions are scheduled.
meeting:update:meeting
Update meeting details when sessions are rescheduled.
meeting:delete:meeting
Delete meetings when sessions are cancelled.
meeting:read:meeting
Retrieve meeting details (join URL, start URL) after creation or update.
meeting:read:list_meetings
List upcoming meetings to display and sync session schedules.
user:read:user
Read your Zoom account profile (name, email) to associate your account with BetterBeing.

No recording, transcription, or participant management permissions are requested. Your OAuth authorization tokens are stored in encrypted form and used solely to perform the above API calls on your behalf. For full details, see our Privacy Policy.

Disconnecting Zoom

You can disconnect your Zoom account from BetterBeing at any time.

From BetterBeing

  1. 1.Go to BetterBeing Console → Video Accounts → Zoom.
  2. 2.Click "Disconnect."
  3. 3.Confirm the disconnection when prompted.

From Zoom Directly

You can also revoke BetterBeing’s access from your Zoom account:

  1. 1.Log in to your Zoom account at zoom.us.
  2. 2.Navigate to Settings → Integration → Installed Apps.
  3. 3.Find BetterBeing and click "Uninstall" or "Remove."
Important: After disconnecting, previously scheduled session links will no longer function. New sessions will not have Zoom links until you reconnect.

Troubleshooting

Connection status shows as Expired
  • Zoom periodically requires re-authorization for security. This is normal and does not affect your existing sessions.
  • Navigate to BetterBeing Console → Video Accounts → Zoom and click "Reauth."
  • Complete the Zoom authorization flow. Your connection will be restored immediately.
Zoom meeting links are not being generated
  • Confirm your Zoom account is connected in BetterBeing Console → Video Accounts → Zoom.
  • Try disconnecting and reconnecting your Zoom account.
  • Ensure your Zoom account tier allows meeting creation.
Authorization fails or redirects to an error
  • Clear your browser cache and cookies and try again.
  • Ensure you are logged into the correct Zoom account.
  • Disable browser extensions that may block third-party OAuth flows.
Calendar events are missing Zoom links
  • Verify Zoom is connected before scheduling the session. Links are only generated at session creation time.
  • Delete the session and recreate it with Zoom connected.
Account lacks permission to create meetings
  • Some Zoom accounts managed by an organization may restrict external apps from creating meetings.
  • Contact your Zoom administrator to enable third-party meeting creation for your account.

FAQ

Does BetterBeing access my Zoom recordings?
No. BetterBeing does not access, store, or process Zoom session recordings, video, or audio content.
Can I use a free Zoom account?
Yes. A free Zoom account supports meeting creation and is sufficient for the BetterBeing integration. Note that free accounts have a 40-minute limit on group meetings.
Can multiple practitioners in my clinic each connect their own Zoom accounts?
Yes. Each practitioner connects their own Zoom account individually. Meeting links are generated using each practitioner's own Zoom credentials.
What happens to existing Zoom links if I disconnect my account?
Existing meeting links will no longer be valid after disconnection. New sessions will not have Zoom links until you reconnect.
What data is sent to Zoom?
Only meeting parameters (topic, start time, duration, settings). No clinical records or client information are transmitted to Zoom.
Is my data shared with Zoom beyond what is needed to create meetings?
No. BetterBeing only transmits meeting parameters (time, duration, topic) to Zoom to create meetings. We do not share client records or clinical data with Zoom. See our Privacy Policy for full details.
What happens to my Zoom data if I delete my BetterBeing account?
All stored meeting metadata and OAuth tokens associated with your Zoom integration are deleted within 30 days of account deletion, in accordance with our Privacy Policy.

Support

If you are unable to resolve an issue using this documentation, contact our support team:

MapTogether Inc. — BetterBeing Support
Response time: within 1 business day for technical issues