Zoom Plugin

Mattermost’s open source Zoom plugin enables users to start and join voice, video and screensharing meetings using either Zoom’s self-hosted private cloud or on-prem solutions, or its vendor-hosted SaaS solution.

The plugin is installed by default and can be quickly activated.


Once enabled, clicking a video icon in a Mattermost channel invites team members to join a Zoom call, hosted using the credentials of the user who initiated the call.


Using other voice, video and screensharing services

The open source Zoom plugin can be used as a sample to create other audio and video conferencing extensions, including custom self-hosted services and vendor-hosted SaaS services such as WebEx, Skype for Business and Google Hangouts, depending on your needs.

The following guide outlines the steps for enabling Zoom.

Zoom Setup Guide

  1. Go to System Console > Plugins > Zoom to configure the Zoom Plugin.
  1. If you’re using a self-hosted private cloud or on-premise Zoom server, enter the Zoom URL and Zoom API URL for the Zoom server, for example https://yourzoom.com and https://api.yourzoom.com/v2 respectively. Leave blank if you’re using Zoom’s vendor-hosted SaaS service.
  2. Set the API Key and API Secret, generated by Zoom and used to create meetings and pull user data:
  • Go to https://marketplace.zoom.us/ and log in.
  • In the top left click on Develop and then Build App.
  • Enter a name for your app and disable Intend to publish this app on Zoom Marketplace.
  • Choose Account-level app as the app type.
  • Select JWT API Credentials as authentication type.
  • Click Create.
  • Enter the Company Name and Developer Contact Information for your app.
  • Go to the App Credentials tab on the left. Here you’ll find your API Key and API Secret.
  • Paste the API Key and API Secret into the fields in the System Console, and hit Save.


To generate an API Key and API Secret requires a Pro, Business, Education, or API Zoom plan.

Only one paid account is required to generate an API Key and API Secret. Other team members can use a free Zoom plan to create and join Zoom meetings in Mattermost.

  1. Enable settings for overriding usernames and overriding profile picture icons.
  2. Activate the plugin at System Console > Plugins > Management by clicking Activate for Zoom.

Once activated, you will see a video icon in the channel header. Clicking the icon will open a drop-down menu with three actions you can take: Start Zoom Meeting Now, Start Zoom Meeting with Topic, and Share Zoom Meeting.



Users will need to sign-up for their own Zoom account using the same email address that they use for Mattermost. If the user attempts to start a Zoom meeting without a Zoom account, they will see the following error message: “We could not verify your Mattermost account in Zoom. Please ensure that your Mattermost email address matches your Zoom email address.” In addition, the user must be added to the admin’s Zoom account to quickly start a meeting without having to share a personal meeting ID.