Zoom Meetings Setup Guide

This article will guide you through how to configure Maptician to integrate with Zoom Meetings.

+ More

Table of Contents

Before you Start Getting Started Step 1: Configure the Zoom API Authorization Step 2: Create the custom Maptician Appas Step 3: Save Account ID, Client ID, and Client Secret Step 4: Enter Required Company and Developer Information Step 5: Continue Without Recording Tokens Step 6: Add and Select the Required Meeting Scopes Option A: Use Only the Required Scopes Option B: Enable All Available Granular Scopes Step 7: Review and Confirm Meeting Scopes Step 8: Activate the Zoom Integration App Step 9: Configure Zoom Integration in Maptician Step 10: Verify Zoom Credentials in Maptician Step 11: Create a Zoom Meeting in Maptician Configure Default Zoom Meeting Options

Before you Start

Before starting, there are a few things you will need:

Zoom account with Admin access
Account Admin access to your Maptician environment. This only applies if you are configuring the integration on your own without assistance from Maptician
IMPORTANT: Non-admin user Permission Groups require the Reservation permission “Group members can create online meetings (Teams/Zoom)” to be enabled to have the ability to create a Zoom meeting in Maptician.

Getting Started

Step 1: Configure the Zoom API Authorization

Sign in to Zoom.
Browse to https://marketplace.zoom.us/develop/create
Choose the Server-to-Server OAuth app and click Create.

Step 2: Create the custom Maptician Appas

Enter a name for the app, such as “Maptician Zoom Integration”, and click Create.

Step 3: Save Account ID, Client ID, and Client Secret

Copy and save the Account ID, Client ID, and Client Secret. These will need to be added to Maptician in a later step.

Step 4: Enter Required Company and Developer Information

Enter a Company Name, Developer Name, and Email (Zoom requires this information to be entered).

👉 For the Developer Name, we recommend using a generic name that puts your company’s name with a description of the integration (e.g., “[Your Company Name] Zoom Integration”) rather than the name of a person.,

👉 For the Email, use a shared or service account within your organization’s domain (e.g., zoom-integration@[yourcompany].com). This ensures that Zoom notifications (such as meeting cancellations) are tied to a neutral integration account instead of showing a specific employee’s identity.

Step 5: Continue Without Recording Tokens

Click Continue on the page below. The tokens do not need to be recorded.

Step 6: Add and Select the Required Meeting Scopes

Note: Zoom now offers a large list of granular scopes. You can enable only the scopes required for Maptician or you can enable all available scopes if you prefer the broadest coverage to avoid any loss of functionality. Below are the two options you can choose from.

Option A: Use Only the Required Scopes

These are the scopes originally required by Maptician:

meeting:write:registrant:admin: Add a registrant to a meeting (meeting)
meeting:write:open_app:admin: Add an open app to a meeting (meeting)
meeting:write:batch_registrants:admin: Add registrants to a meeting (meeting)
meeting:write:meeting:admin: Create a meeting for a user (meeting)
meeting:write:template:admin: Create a meeting template from an existing meeting (meeting)
meeting:write:poll:admin: Create a poll for a meeting (meeting)
meeting:write:invite_links:admin: Create invite links for a meeting (meeting)
meeting:write:batch_polls:admin: Create polls for a meeting (meeting)
meeting:delete:meeting:admin: Delete a meeting (meeting)
meeting:delete:poll:admin: Delete a meeting poll (meeting)
meeting:delete:survey:admin: Delete a meeting survey (meeting)
meeting:delete:live_meeting_chat_message:admin: Delete a message in a live meeting (meeting)
meeting:delete:open_app:admin: Remove a meeting open app (meeting)
meeting:delete:registrant:admin: Remove a meeting registrant (meeting)
meeting:update:meeting:admin: Update a meeting (meeting)
meeting:update:registrant_status:admin: Update a meeting registrant status (meeting)
meeting:update:in_meeting_controls:admin: Update a meeting in meeting control (meeting)
meeting:update:livestream:admin: Update a meeting livestream information (meeting)
meeting:update:livestream_status:admin: Update a meeting livestream status (meeting)
meeting:update:poll:admin: Update a meeting poll (meeting)
meeting:update:registration_question:admin: Update a meeting registration question (meeting)
meeting:update:status:admin: Update a meeting status (meeting)
meeting:update:survey:admin: Update a meeting survey (meeting)
meeting:update:live_meeting_chat_message:admin: Update a message in a live meeting (meeting)
meeting:read:meeting:admin: View a meeting (meeting)
sip_phone:write:sip_phone:admin: Create a Sip Phone on Zoom (sip phone)
sip_phone:delete:sip_phone:admin: Delete a Sip Phone on Zoom (sip phone)
sip_phone:update:sip_phone:admin: Edit a Sip Phone on Zoom (sip phone)
sip_phone:read:list_sip_phones:admin: List all Sip Phones (sip phone)
meeting:write:sip_dialing:admin: Get a meeting SIP URI with passcode (meeting)
webinar:write:sip_dialing:admin: Get a webinar SIP URI with passcode (webinar)

Option B: Enable All Available Granular Scopes

If you want the broadest possible coverage you can select every permission within your custom Zoom application for Maptician. This includes every permission from Option A and every granular permission listed below. You can do this quickly by choosing the “Select All (Admin)” option in the Zoom scope selector (seen in screenshot below).

IMPORTANT: Zoom manages and maintains the full set of available scopes and may update or change them at any time. New scopes may be added and existing scopes may be adjusted or removed. Because of this the list below may not always match the current scope set shown in your Zoom configuration.

For additional details on Zoom’s Granular API settings you can review their documentation here: Integrations - Granular scopes

All Granular Scopes

Archiving

archiving:read:list_archived_files:admin: Get an account archived meeting or webinar files (archiving)
archiving:read:archived_files:admin: Return a specific meeting instance archived files (archiving)

Device Management

device:write:zdm_device:admin: Add device (device)
device:write:zpa_device:admin: Assign device (device)
device:read:user_setting:admin: Get user ZPA device list and profile setting (device)
device:read:list_zpa_versions:admin: List ZPA versions (device)
device:write:vendor_device:admin: Manage vendor device (device)
device:write:vendor_import_result:admin: Manage vendor device import result (device)
device:update:zdm_device_assignment:admin: View Zoom Device Management devices (device)
device:delete:zpa_device:admin: Delete ZPA device (device)
device:delete:zdm_device:admin: Delete device (device)
device:read:command:admin: Device command (device)
device:write:group:admin: Device group change (device)
device:read:import_device:admin: Import device (device)
device:read:list_zdm_devices:admin: List devices (device)
device:read:list_groups:admin: List groups (device)
device:read:zdm_device:admin: Read device (device)
device:update:zdm_device:admin: Update device (device)
device:write:zpa_os_app:admin: Upgrade device (device)

Meeting Reading Scopes

meeting:read:token:admin: View a meeting closed caption token caption URL (meeting)
meeting:read:past_qa:admin: List Q and A of a specific meeting (meeting)
meeting:read:risk_alert:admin: View a meeting at risk (meeting)
meeting:read:live_streaming_token:admin: View a meeting live streaming join token (meeting)
meeting:read:local_archiving_token:admin: View a meeting local archiving join token (meeting)
meeting:read:local_recording_token:admin: View a meeting local recording join token (meeting)
meeting:read:participant_callout:admin: View a meeting participant callout (meeting)
meeting:read:participant_feedback:admin: View a meeting participant feedback (meeting)
meeting:read:alert:admin: View a meeting alert (meeting)
meeting:read:chat_message:admin: View a meeting chat message (meeting)
meeting:read:device:admin: View a meeting device test result (meeting)
meeting:read:invitation:admin: View a meeting invitation (meeting)
meeting:read:livestream:admin: View a meeting livestream information (meeting)
meeting:read:participant:admin: View a meeting participant (meeting)
meeting:read:participant_sharing:admin: View a meeting participant sharing detail (meeting)
meeting:read:poll:admin: View a meeting poll (meeting)
meeting:read:list_polls:admin: View a meeting polls (meeting)
meeting:read:registrant:admin: View a meeting registrant (meeting)
meeting:read:list_registrants:admin: View a meeting registrants (meeting)
meeting:read:list_registration_questions:admin: View a meeting registration questions (meeting)
meeting:read:list_summaries:admin: View a meeting summaries (meeting)
meeting:read:summary:admin: View a meeting summary (meeting)
meeting:read:survey:admin: View a meeting survey (meeting)
meeting:read:past_meeting:admin: View a past meeting (meeting)
meeting:read:list_past_instances:admin: View a past meeting instances (meeting)
meeting:read:list_past_participants:admin: View a past meeting participants (meeting)
meeting:read:list_poll_results:admin: View a past meeting polls (meeting)
meeting:read:list_templates:admin: View a user meeting templates (meeting)
meeting:read:list_meetings:admin: View a user meetings (meeting)
meeting:read:list_upcoming_meetings:admin: View a user upcoming meetings (meeting)
meeting:read:ai_companion:admin: View all user meetings (meeting)

Meeting Management and Write Scopes

meeting:delete:summary:admin: View and manage all user meeting summaries (meeting)
meeting:update:participant_rtms_app_status:admin: View and manage all user meetings (meeting)

PAC

pac:read:list_pac_accounts:admin: View a user PAC accounts (pac)

Tracking Fields

tracking_field:write:tracking_field:admin: Create a tracking field (tracking field)
tracking_field:delete:tracking_field:admin: Delete a tracking field (tracking field)
tracking_field:update:tracking_field:admin: Update a tracking field (tracking field)
tracking_field:read:tracking_field:admin: View a tracking field (tracking field)
tracking_field:read:list_tracking_fields:admin: View tracking fields (tracking field)

TSP

tsp:write:tsp_account:admin: Add a TSP account to a user (tsp)
tsp:delete:tsp_account:admin: Delete a user TSP account (tsp)
tsp:read:tsp:admin: Get an account TSP information (tsp)
tsp:update:tsp_account:admin: Update a user TSP account (tsp)
tsp:update:tsp_settings:admin: Update a user TSP global dial in URL (tsp)
tsp:update:tsp:admin: Update an account TSP information (tsp)
tsp:read:tsp_account:admin: View a user TSP account (tsp)
tsp:read:list_tsp_accounts:admin: View a user TSP accounts (tsp)

Webinar Write and Management

webinar:write:registrant:admin: Add a registrant to a webinar (webinar)
webinar:write:panelist:admin: Add panelists to a webinar (webinar)
webinar:write:batch_registrants:admin: Add registrants to a webinar (webinar)
webinar:write:poll:admin: Create a poll for a webinar (webinar)
webinar:write:webinar:admin: Create a webinar for a user (webinar)
webinar:write:template:admin: Create a webinar template from an existing webinar (webinar)
webinar:write:branding_name_tag:admin: Create a webinar branding name tag (webinar)
webinar:write:invite_links:admin: Create invite links for webinars (webinar)
webinar:delete:live_webinar_chat_message:admin: Delete a message in a live webinar (webinar)
webinar:delete:webinar:admin: Delete a webinar (webinar)
webinar:delete:branding_virtual_background:admin: Delete a webinar branding virtual background (webinar)
webinar:delete:branding_name_tag:admin: Delete a webinar branding name tag (webinar)
webinar:delete:branding_wallpaper:admin: Delete a webinar branding wallpaper (webinar)
webinar:delete:poll:admin: Delete a webinar poll (webinar)
webinar:delete:survey:admin: Delete a webinar survey (webinar)

Webinar Reading

webinar:read:token:admin: Get a webinar closed caption token caption URL (webinar)
webinar:read:branding:admin: Get webinar session branding (webinar)
webinar:delete:panelist:admin: Remove a webinar panelist (webinar)
webinar:delete:registrant:admin: Remove a webinar registrant (webinar)
webinar:update:branding_virtual_background:admin: Set a webinar default branding virtual background (webinar)
webinar:update:webinar:admin: Update a webinar (webinar)
webinar:update:registrant_status:admin: Update a webinar registrant status (webinar)
webinar:update:branding_name_tag:admin: Update a webinar branding name tag (webinar)
webinar:update:livestream:admin: Update a webinar livestream information (webinar)
webinar:update:livestream_status:admin: Update a webinar livestream status (webinar)
webinar:update:poll:admin: Update a webinar poll (webinar)
webinar:update:registration_question:admin: Update a webinar registration questions (webinar)
webinar:update:status:admin: Update a webinar status (webinar)
webinar:update:survey:admin: Update a webinar survey (webinar)
webinar:write:branding_virtual_background:admin: Upload a webinar branding virtual background (webinar)
webinar:write:branding_wallpaper:admin: Upload a webinar branding wallpaper (webinar)

Webinar Past Data and Insights

webinar:read:past_qa:admin: View a past webinar Q and A (webinar)
webinar:read:list_absentees:admin: View a past webinar absentees (webinar)
webinar:read:list_past_instances:admin: View a past webinar instances (webinar)
webinar:read:list_past_participants:admin: View a past webinar participants (webinar)
webinar:read:list_past_polls:admin: View a past webinar polls (webinar)

Webinar Lists and Details

webinar:read:list_templates:admin: View a user webinar templates (webinar)
webinar:read:list_webinars:admin: View a user webinars (webinar)
webinar:read:webinar:admin: View a webinar (webinar)
webinar:read:live_streaming_token:admin: View a webinar live streaming join token (webinar)
webinar:read:local_archiving_token:admin: View a webinar local archiving join token (webinar)
webinar:read:local_recording_token:admin: View a webinar local recording join token (webinar)
webinar:read:participant_feedback:admin: View a webinar participant feedback (webinar)
webinar:read:alert:admin: View a webinar alert (webinar)
webinar:read:chat_message:admin: View a webinar chat message (webinar)
webinar:read:livestream:admin: View a webinar livestream information (webinar)
webinar:read:list_panelists:admin: View a webinar panelists (webinar)
webinar:read:participant:admin: View a webinar participant (webinar)
webinar:read:participant_sharing:admin: View a webinar participant sharing detail (webinar)
webinar:read:poll:admin: View a webinar poll (webinar)
webinar:read:list_polls:admin: View a webinar polls (webinar)
webinar:read:registrant:admin: View a webinar registrant (webinar)
webinar:read:list_registrants:admin: View a webinar registrants (webinar)
webinar:read:list_registration_questions:admin: View a webinar registration questions (webinar)
webinar:read:survey:admin: View a webinar survey (webinar)
webinar:read:list_tracking_sources:admin: View a webinar tracking sources (webinar)
webinar:read:jointoken_3rd_recording:admin: View a webinar join token for third party recording (webinar)
webinar:write:resource_document:admin: Write webinar resource document (webinar)

After choosing either Option A or Option B, proceed with the steps below to add and configure the required Zoom scopes.

Click the Add Scopes button.

In the search box type Meeting and then select the Meeting Product option.
In the selection panel, scroll and find View and manage all user meetings.
Select the permissions needed for your integration.
Select Done.

Step 7: Review and Confirm Meeting Scopes

You will be taken to the screen below, which displays the list of Meeting Scopes that you added in the previous step. Click the Continue button to activate the app.

Step 8: Activate the Zoom Integration App

Activate the app by clicking “Activate your app”. If activation is successful, you will see the confirmation screen shown below. Continue to the next page to configure the Zoom Integration in your Maptician environment.

Step 9: Configure Zoom Integration in Maptician

In your Maptician environment, click on the settings button (1) to open the Maptician Settings
In the settings panel, click on the Environment tab (2) and then the Zoom Integration tab (3)
Enter your Zoom Account ID, Client ID, and Client Secret that you previously created in Step 3
Click the green SAVE CHANGES button (4)

Step 10: Verify Zoom Credentials in Maptician

Confirm that your Zoom credentials are working by clicking the blue CHECK CONNECTION button. An example of a successful connection is shown below.

Step 11: Create a Zoom Meeting in Maptician

Open a room calendar from within one of your maps
Select a date and time for the reservation
Toggle on the “Create Zoom Meeting” option
Click Reserve Room. The reservation email you receive should have a Zoom Meeting invite (example shown below)

Configure Default Zoom Meeting Options

Now that you have your Zoom integration set up, you are able to configure your environment's default Zoom meeting options. Follow the steps below to set this up:

Open a room calendar from within one of your maps
Select a date and time for the reservation
Toggle on the “Create Zoom Meeting” option
Click the settings cog icon
Configured the meeting options as you desire
Click the “Save as Default” button
1. After setting this, refresh your page and start a new reservation to confirm the options are set correctly.