Use of this sample app is subject to our Terms of Use.

NOTE: This sample app has been updated to use Meeting SDK app type credentials instead of JWT app type type credentials.

This is a Node.js / Express server that generates a Meeting SDK JWT via an HTTP request for authorized use of the Zoom Meeting SDK.

If you would like to skip these steps and just deploy the finished code to Heroku, click the Deploy to Heroku button. (You will still need to configure a few simple things, so skip to Deployment.)

In terminal, run the following command to clone the repo:

$ git clone https://github.com/zoom/meetingsdk-auth-endpoint-sample.git

1. In terminal, cd into the cloned repository:

   $ cd meetingsdk-auth-endpoint-sample

2. Then install the dependencies:

   $ npm install

3. Rename .env.example to .env, edit the file contents to include your Zoom Meeting SDK key and secret, save the file contents, and close the file.

4. Start the server:

   $ npm run start

Make a POST request to http://localhost:4000 (or your deployed url) with the following request body:

POST http://localhost:4000

Request Body:

{
  "meetingNumber": "123456789",
  "role": 0
}

If successful, the response body will be a JSON representation of your Meeting SDK JWT:

{
  "signature": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZGtLZXkiOiJhYmMxMjMiLCJtbiI6IjEyMzQ1Njc4OSIsInJvbGUiOjAsImlhdCI6MTY0NjkzNzU1MywiZXhwIjoxNjQ2OTQ0NzUzLCJhcHBLZXkiOiJhYmMxMjMiLCJ0b2tlbkV4cCI6MTY0Njk0NDc1M30.UcWxbWY-y22wFarBBc9i3lGQuZAsuUpl8GRR8wUah2M"
}

In the Meeting SDK, pass in the signature to the join() function:

// Make http request to your auth endpoint to get the Meeting SDK JWT

// Meeting SDK - web - Client View - example:
ZoomMtg.join({
  signature: signature,
  sdkKey: sdkKey,
  userName: userName,
  meetingNumber: meetingNumber,
  passWord: password
})

// Meeting SDK - web - Component View - example:
client.join({
  signature: signature,
  sdkKey: sdkKey,
  userName: userName,
  meetingNumber: meetingNumber,
  password: password
})

1. After clicking the "Deploy to Heroku" button, enter a name for your app (or leave it blank to have a name generated for you), and insert your Zoom Meeting SDK credentials:

   • ZOOM_MEETING_SDK_KEY (Your Zoom Meeting SDK Key or Client ID for Meeting SDK app type's created after February 11, 2023, found on your Zoom Meeting SDK App Credentials page)
   • ZOOM_MEETING_SDK_SECRET (Your Zoom Meeting SDK Secret or Client Secret for Meeting SDK app type's created after February 11, 2023, found on your Zoom Meeting SDK App Credentials page)

2. Then click "Deploy App".

3. Use your Heroku URL as your Meeting SDK Auth Endpoint.

   Example: https://abc123.herokuapp.com/

1. If you cloned this repo, you may use the Heroku CLI to deploy your server. Remember to set your config vars (envoirnment variables).

2. Use your Heroku URL as your Meeting SDK Auth Endpoint.

   Example: https://abc123.herokuapp.com/

1. For Other Server Hosting information, see this tutorial.

2. Use your deployed URL as your Meeting SDK Auth Endpoint.

   Example: https://abc123.compute-1.amazonaws.com/

Now you can generate your Meeting SDK JWT.

If you're looking for help, try Developer Support or our Developer Forum. Priority support is also available with Premier Developer Support plans.