ZenotiHelp

Configure Zoom integration

ZTZenoti Docs Team Updated October 27, 2026 7 min readHow-to

The Zoom integration lets Zenoti create Zoom meetings for virtual appointments and classes. On the Zenoti side it is a single accordion with two settings: whether Zoom is on, and how many Zoom licenses the organization holds. The guest-facing join button is configured separately in the online booking settings. This article covers both, and the setup failures that leave a meeting link out of some guest messages.


On this page


Before you begin

Permission: You need organization administrator access to configure the Zoom integration.

  • Your organization must have a Zoom account with enough licenses for the virtual meetings that run at the same time. Zenoti uses one license per concurrent meeting.
  • Virtual services and classes must be set up before meeting links can be generated for them.

External-system prerequisites (Zoom side)

Before turning Zoom on, your Zoom administrator should complete the following in the Zoom Admin portal.

Prerequisite Owner Where it is done
Zoom subscription with enough licenses for concurrent virtual meetings Zoom administrator Zoom Admin portal billing section
Default meeting policies (waiting rooms, passwords, recording) aligned with your privacy and compliance posture Zoom administrator Zoom Admin portal meeting settings

For the exact Zoom menu paths, refer to Zoom's Admin documentation; the paths vary by Zoom account type.


Network requirements

Direction Protocol / port Purpose Who whitelists
Outbound from Zenoti to Zoom HTTPS (port 443) Meeting creation API calls Managed by Zenoti β€” no action needed
Outbound from guest / provider device to Zoom HTTPS (port 443) + Zoom media ports Joining the meeting End-user network

Plain HTTP is not supported. If your organization proxies outbound traffic, confirm the Zoom hostnames used by your Zoom plan are reachable from the guest and provider devices that will join meetings.


Turn Zoom on

  1. Navigate to Configuration > Integrations > Integration settings and expand Zoom.
  2. In Configuration, turn on Enable Zoom.
  3. Enter Number Of License Purchased: the number of Zoom licenses your organization holds. Zenoti uses it as the ceiling for concurrent meetings.
  4. Select Save. Zenoti confirms with Changes has been saved successfully.

If the accordion shows Zoom is not enabled for your Organization. Please contact Zenoti support for further assistance., the integration is not available on your tenant yet.


Configure the guest join button

The join button that guests see on the Webstore and the consumer mobile app is governed by three settings in the Webstore V2 online booking settings, not on the Zoom accordion.

  1. Navigate to Configuration > Online booking and open the Webstore V2 settings.

  2. In the Technical & Integrations section, under Integrations, set these settings:

    Setting Effect
    Zoom Meeting Button Lead Time (Minutes) How many minutes before the appointment the Zoom join button becomes available to the guest.
    Show Virtual Meeting Button X Minutes Before How many minutes before the appointment the virtual meeting button is shown.
    Pre-meeting Message The message guests see before the meeting starts.
  3. Save the online booking settings.

See Configure online booking settings for the Webstore V2 page.


Turn Zoom off

  1. Expand Zoom on the Integration settings page and turn off Enable Zoom.
  2. Zenoti asks Are you sure you want to disable Zoom integration? and warns: Turning off Zoom integration will also disable virtual appointments since that functionality is dependent on Zoom integration.
  3. Confirm, then select Save.

Existing meeting links already sent to guests remain valid in Zoom, but Zenoti creates no new meetings while the switch is off.


Verify the integration

  1. Create a test appointment for a virtual service with a test guest.
  2. Confirm the appointment carries a Zoom meeting and that the confirmation sent to the guest includes the join link.
  3. Confirm the meeting appears in your Zoom account's upcoming meetings list.
  4. Join the meeting as both guest and provider to confirm media connectivity.
  5. Reschedule the test appointment to a different time, then confirm the reschedule message the guest receives carries a meeting link and that the link opens a working meeting. Rescheduling replaces the appointment's Zoom meeting, so this step checks both that the Appointment Rescheduled template carries the meeting-link macro and that the new meeting is reachable.
  6. Cancel the test appointment and confirm the meeting is released.

What to configure next

Required:

Recommended:


Handle setup failures

Failure mode User-visible symptom Resolution
The accordion shows Zoom is not enabled for your Organization. Zoom is not available on the tenant. Contact Zenoti Support as the message says.
Changes has not been saved successfully The save failed, for example because Number Of License Purchased is empty or not a number. Correct the value and select Save again.
Virtual appointment created but no meeting link in the confirmation Enable Zoom is off, or the concurrent meetings already equal Number Of License Purchased. Turn Zoom on, or raise the license count after buying licenses in Zoom.
The meeting link reaches the guest in some messages but not others β€” for example in the confirmation but not in a reminder or after a reschedule The template being sent does not carry the meeting-link macro. Every appointment template carries its own macros, so adding the macro to the confirmation does not add it to the reminders or the reschedule message. In Configuration > Notifications > Templates for email and text, open every template the guest receives β€” Appointment Confirmation, Appointment Confirmation - Online Booking, First Appointment Reminder, Second Appointment Reminder and Appointment Rescheduled, plus the group confirmation templates if you book group virtual appointments β€” and confirm each carries [ServiceNameVideoLinkList] in both its email and text versions. See Configure notification template macros.
Guests cannot see the join button until the last moment Zoom Meeting Button Lead Time (Minutes) is too low. Raise the lead time in the Webstore V2 online booking settings.

Rescheduling a virtual appointment replaces its Zoom meeting, so the link in messages sent before the change stops working. The macro is filled in when each message is sent, so the Appointment Rescheduled message and any later reminder carry the new link only if their templates carry the macro. A guest who was sent a confirmation and then a reschedule message with no macro keeps only the old, dead link.


Tips

  • Keep Number Of License Purchased equal to your Zoom plan. A lower value blocks meeting creation before Zoom would; a higher value lets bookings exceed what Zoom can host.
  • Set Zoom Meeting Button Lead Time (Minutes) to 10 to 15 minutes so guests can join early without the button appearing hours ahead.
  • Audit the macro across all appointment templates at once rather than one at a time. A gap only shows up in the one message type that is missing it, which is straightforward to miss when the confirmation works.
  • Enable waiting rooms and passwords in your Zoom account settings for sensitive appointment types such as consultations or medical visits.
  • Test a virtual appointment after any change to the Zoom accordion or to the notification templates, and include a reschedule in the test.

Troubleshooting

The meeting link is missing from reminders even though it appears in the confirmation.

Each appointment notification template manages its own macros independently. Adding [ServiceNameVideoLinkList] to the Appointment Confirmation template does not propagate it to First Appointment Reminder, Second Appointment Reminder, Appointment Rescheduled, or any group confirmation template. Open each template individually in Configuration > Notifications > Templates for email and text and verify that [ServiceNameVideoLinkList] appears in both the email body and the text version of every template the guest receives. See Configure notification template macros.

After rescheduling, the guest's original link no longer works.

Rescheduling a virtual appointment creates a new Zoom meeting and invalidates the previous one. The original confirmation link stops working as soon as the reschedule completes. For the guest to receive the new link automatically, the Appointment Rescheduled template must include [ServiceNameVideoLinkList]. If the template is missing the macro, add it and then send the guest the new link manually, or ask the guest to check the reschedule confirmation message once the template is corrected.

Meeting creation silently fails at peak hours even though Enable Zoom is on.

Zenoti blocks new meeting creation once the number of concurrent active meetings reaches the value in Number Of License Purchased. If your Zoom plan supports more concurrent meetings than that value, raise Number Of License Purchased to match and select Save. If the plan itself is the limit, coordinate with your Zoom administrator to add licenses before peak periods.


Was this article helpful?
Your feedback helps us improve our documentation.