Meetings

The ZoomMtg.join() function is used to start and join Zoom meetings.

On this page

• Prerequisites
• Start meeting
• Join meeting
• Join meeting with registration required
• Join meeting with authentication required

Prerequisites

Each ZoomMtg.join() call needs to be inside the ZoomMtg.init() success callback.

Here are the properties for the ZoomMtg.join() function. You can get the meeting number, password, and registrant token from the Zoom Meeting APIs.

For the full set of ZoomMtg.init() and ZoomMtg.join() properties, as well as the Meeting SDK for Web APIs and event listeners, see the client view reference.

Start meeting

To start a Zoom meeting, you must use a role value of 1 in your SDK signature, and pass in the meeting host's zak token. This enables the Meeting SDK for Web to start the meeting.

ZoomMtg.init({
  leaveUrl: leaveUrl, // https://example.com/thanks-for-joining
  success: (success) => {
    ZoomMtg.join({
      sdkKey: sdkKey,
      signature: signature, // role in SDK signature needs to be 1
      meetingNumber: meetingNumber,
      passWord: passWord,
      userName: userName,
      zak: zakToken, // the host's ZAK token
      success: (success) => {
        console.log(success)
      },
      error: (error) => {
        console.log(error)
      }
    })
  },
  error: (error) => {
    console.log(error)
  }
})

Join meeting

To join a Zoom meeting, you must use a role value of 0 in your SDK signature. This enables the Meeting SDK for Web to join any meeting.

ZoomMtg.init({
  leaveUrl: leaveUrl, // https://example.com/thanks-for-joining
  success: (success) => {
    ZoomMtg.join({
      sdkKey: sdkKey,
      signature: signature, // role in SDK signature needs to be 0
      meetingNumber: meetingNumber,
      passWord: passWord,
      userName: userName,
      success: (success) => {
        console.log(success)
      },
      error: (error) => {
        console.log(error)
      }
    })
  },
  error: (error) => {
    console.log(error)
  }
})

Join meeting with registration required

Meeting SDK for Web client view v1.9.6 and above enables users to join registered meetings automatically. Your app handles the join process automatically using the registration token retrieved via the Zoom API.

This feature uses the registration token denoted by the tk value in the query parameter in the registrant's join_url:

{
  "join_url": "https://example.zoom.us/w/12345?tk=TOKEN"
}

To get a registrant's token and join the meeting

1. Call Add meeting registrant, List meeting registrants, or Update registrant's status.

2. Get the tk value from the response:

{
  "registrant_id": "ESJWWYqvTDWFGNUqJzB_bQ",
  "id": 96231721187,
  "topic": "My registered websdk meeting",
  "start_time": "2021-05-31T14:00:00Z",
  "join_url": "https://example.zoom.us/w/12345?tk=JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz&pwd=Ri0TkdxhXeWRUOITyT3ZDZmOOOGwxQT09&uuid=XX_pII1ZlzIQ42xx3zA2zYrrU"
}

The tk value above is JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz

JavaScript example

var registrantToken = new URL(response.join_url).searchParams.get('tk')

// Let's imagine that the response is the same and the tk value is:
// JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz

3. Set the registrant token as the value for tk in ZoomMtg.join():

ZoomMtg.init({
  leaveUrl: leaveUrl, // https://example.com/thanks-for-joining
  success: (success) => {
    ZoomMtg.join({
      sdkKey: sdkKey,
      signature: signature,
      meetingNumber: meetingNumber,
      passWord: passWord,
      userName: userName,
      userEmail: userEmail, // userEmail property required
      tk: registrantToken, //JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz
      success: (success) => {
        console.log(success)
      },
      error: (error) => {
        console.log(error)
      }
    })
  },
  error: (error) => {
    console.log(error)
  }
})

Join meeting with authentication required

When using the Web SDK, meeting hosts can require their participants to authenticate either through Single-Sign On (SSO) or from specific domains. Follow the steps below to enable authentication on an account and join an authenticated user through the Web SDK.

Configure account authentication settings

Within Account Settings, first enable the setting Only authenticated users can join meetings. Next you'll need to configure whether the meeting requires Single-Sign On or specific domains to authenticate.

Require Single-Sign On (SSO)

See Single Sign-On for details.

Click Add Configuration. In the Authentication Configuration, select Sign in to external Single Sign-On (SSO) as the authentication method.

Require specific domains

Click Add Configuration. In the Authentication Configuration, select Sign in to Zoom with specified domains as the authentication method. Enter your domain, and click Save.

Enable user-level default settings

Within a user's Profile Settings, enable the setting Only authenticated users can join meetings. This can be set as the default for the user's hosted meetings.

Scheduling meetings with authentication profiles

When creating a scheduled meeting, ensure authentication is required in Meeting Options. When scheduling, choose Only authenticated users can join and choose an authentication option.

User accepts authorization

A Zoom Meeting Web SDK Helper application will pop up requesting authorization through OAuth. If authorized, a user will then sign in using their Zoom account through email, Google/Facebook, or SSO.

After authorizing, the user will be able to join the meeting.

Users who see an error message “You cannot authorize the app” will need to install the Web SDK helper app.