Join a Meeting

Meetings are joined in the Web SDK using the ZoomMtg.init() method to launch the SDK, then the ZoomMtg.join() to join the user into the meeting. The join method receives an encrypted signature, your API Key, a meeting ID, and any user settings.

Before joining, remember to prepare required files and setup a signature function.

Create a meeting

For testing, create a meeting in your Zoom client or at to retrieve a Meeting ID and passcode. Advanced applications can also use the Meetings API to create and retrieve meetings. If you already have a meeting ID to join, continue on.

Create meetConfig object

To receive user input and meeting settings, create a client-side meetConfig object to pass data to a server-side generateSignature function and the meeting join methods.

Example meetConfig object:

const meetConfig = {
	apiKey: '3239845720934223459'
	meetingNumber: '123456789',
	leaveUrl: '',
	userName: 'Firstname Lastname',
	userEmail: '',
	passWord: 'password', // if required
	role: 0 // 1 for host; 0 for attendee

Please note that when using PMIs for the meetingNumber property, WebSDK attendees are not allowed to join meetings before the host.

Launch & Join Meeting

Pass your meetConfig object to a getSignature function. Make a request to your signature endpoint, then pass that response to call the init method.

In the ZoomMtg.init() method, set any meeting settings (ex: leaveUrl, isSupportAV).

Call the ZoomMtg.join() method as a success param of ZoomMtg.init(). The join() method will handle your signature (as a text string).

import { ZoomMtg } from '@zoomus/websdk'


getSignature(meetConfig) {
			method: 'POST',
			body: JSON.stringify({ meetingData: meetConfig })
		.then(result => result.text())
		.then(response => {
				leaveUrl: meetConfig.leaveUrl,
				isSupportAV: true,
				success: function() {
						signature: response,
						apiKey: meetConfig.apiKey,
						meetingNumber: meetConfig.meetingNumber,
						userName: meetConfig.userName,
						// password optional; set by Host
						passWord: meetConfig.passWord 
						error(res) { 

Set this function to launch within your application, for example, on a “Join Meeting” button.

Joining meetings with reCAPTCHA

As of version 1.7.9, meeting participants might see a reCAPTCHA check to join meetings. To ensure this check is working, run your application on port 80 or 443.

On successful join methods, participants might see a pop up modal with a reCAPTCHA check. After participants successfully complete reCAPTCHA, they will enter the meeting.

Need help?

The first place to look is on our Developer Forum. If you can't find the answer or your request includes sensitive information, contact Developer Support.