Zoom Integration Guide

Prerequisites

• An active Zoom account (free or paid)
• A brandID bookme account (any plan)
• A modern web browser (Chrome, Firefox, Safari, or Edge)

Adding the App (Setup Steps)

Usage

How Meetings Are Created

When a bookee confirms a booking for a Zoom event type, the following happens automatically:

1. A new Zoom meeting is created on your Zoom account with the booking time and duration
2. The unique meeting link is added to the booking confirmation
3. Both you and the bookee receive the Zoom link in your confirmation emails
4. The meeting appears on your connected calendar

Setting an Event Type to Use Zoom

After connecting Zoom, you can assign it as the location for any event type:

1. Go to Scheduling in your dashboard
2. Click Edit on any event type (or create a new one)
3. In the Location field, select Zoom Meeting
4. Save your changes

From this point on, every new booking for that event type will automatically generate a unique Zoom meeting link.

Booking Cancellations

If a booking is cancelled, the associated Zoom meeting is automatically deleted from your Zoom account to keep things clean. If a booking is rescheduled, a new Zoom meeting is created for the updated time.

Permissions We Use

brandID bookme requests only the minimum Zoom permissions needed:

• View and manage meetings — to create meeting links for bookings and delete them when bookings are cancelled
• View user profile — to display your Zoom connection status in the integrations dashboard

We do not access your Zoom recordings, chat messages, webinars, phone data, or any other Zoom features beyond meeting creation.

Removing the App (Disconnecting & Deauthorizing Zoom)

You can fully remove the brandID bookme integration from your Zoom account at any time. There are two equivalent ways to do this — both fully revoke our access to your Zoom account:

Option 1 — Disconnect from brandID bookme (Recommended)

1. Log in to your brandID bookme dashboard
2. Go to Integrations in the sidebar
3. Click the Disconnect button on the Zoom card
4. Confirm the disconnection when prompted

When you click Disconnect, brandID bookme will:

1. Call Zoom's OAuth Revoke endpoint (https://zoom.us/oauth/revoke) to fully invalidate the access token at Zoom's authorization server. This means the token can no longer be used to access your Zoom account, even if it were somehow leaked.
2. Delete your encrypted access token and refresh token from our database immediately and permanently.
3. Stop all future Zoom API access from brandID bookme to your Zoom account.

Option 2 — Remove from Your Zoom Account

1. Log in to your Zoom account at zoom.us
2. Navigate to the Zoom App Marketplace (marketplace.zoom.us/user/installed)
3. Click Manage → Added Apps
4. Find brandID bookme and click Remove
5. Confirm removal in Zoom's dialog

When you remove the app from Zoom's side, Zoom automatically sends a Deauthorization Event Notification (HTTP POST) to our Deauthorization Notification Endpoint (/api/zoom/deauthorize). On receipt, brandID bookme:

1. Immediately purges your encrypted Zoom access token and refresh token from our database.
2. Sends a Compliance Acknowledgment back to Zoom (POST https://api.zoom.us/oauth/data/compliance) confirming we have processed the deauthorization and removed all Zoom data, as required by Zoom App Marketplace policies.

Implications of Deauthorization

Once disconnected or deauthorized through either method, the following occurs:

• OAuth tokens are revoked at Zoom and deleted locally — both server-side at Zoom and in our database. The integration is fully terminated.
• No more API access — brandID bookme can no longer create, read, update, or delete meetings on your Zoom account through the API.
• Existing Zoom meetings are preserved — Zoom meetings that were already created for past and upcoming bookings remain in your Zoom account. We do not delete them upon disconnection. You can manage or delete them yourself from your Zoom account.
• New bookings lose Zoom links — any future bookings for event types set to “Zoom Meeting” will no longer generate Zoom meeting links.
• Event types fall back — event types currently set to “Zoom Meeting” will fall back to the default location (brandID Meet video).

How We Remove Your Data

We take your privacy seriously. Upon disconnection or deauthorization:

• Your Zoom OAuth access token and refresh token are permanently deleted from our database immediately (not soft-deleted, not retained).
• We do not retain any other Zoom-related data — we never stored Zoom meeting recordings, chat messages, account profile data, contact data, phone data, or webinar data in the first place. The only Zoom data we ever stored was the OAuth tokens (so we could create meeting links on your behalf) and the Zoom meeting IDs/URLs attached to your individual bookings.
• Zoom meeting IDs/URLs that were attached to your booking records are retained as part of your booking history (so your past meeting context is preserved). These references are deleted when you delete the corresponding booking, or when you delete your brandID bookme account.
• No data is transferred to Zoom or any third party as part of the disconnection process beyond the required revoke and compliance API calls described above.

For complete data deletion, you can delete your brandID bookme account from the Settings page, which removes all personal data within 30 days. See our Privacy Policy for full details.

Troubleshooting

“Authorization failed” error

This usually means the OAuth flow was interrupted. Try again by clicking Connect on the integrations page. If the issue persists, try clearing your browser cookies for zoom.us and retrying.

Zoom meetings not being created

• Verify your Zoom integration shows as “Connected” on the Integrations page
• Make sure the event type location is set to “Zoom Meeting”
• Check that your Zoom account is active and in good standing
• Try disconnecting and reconnecting the integration

“Insufficient permissions” error

Disconnect the integration and reconnect, making sure to approve all requested permissions on the Zoom consent screen.

Meeting link not in confirmation email

Check your email spam folder. If the booking was created before Zoom was connected, the meeting link won't be retroactively added — it only applies to new bookings.

Still having issues?

Contact our support team at [email protected] or visit our support page for additional help.