Create a JWT App


JSON Web Tokens are strings of text which are passed on every request to verify the authorization of the server. They contain a combination of secrets from the API and payload data in the form of a JSON object. If you want to learn more about JWTs, we recommend our guide on Using JWT with Zoom as well as the full documentation at JWT.io.

By creating a JWT app on the Marketplace, you can build a server-server authenticated app which allows users as well as other apps to consume its services.

Tip: If you’re looking to build an app that allows individual users to manager their accounts, you may want to build an app using OAuth instead.

Register Your App

To register your app, visit the Zoom App Marketplace and click on the Develop option in the dropdown on the top-right corner and select Build App. A page with various app types will be displayed. Select JWT as the app type and click on Create.

App Information

After creating your app, your first step is to fill out descriptive and contact information. Here you enter a short description along with your company name. This is also where you can change the name you’ve just given to your app. Please note that this unique app name will be visible, even if your app is not submitted publicly.

Next add Developer Contact name and email, which may be used by the Zoom Marketplace Team or your users for any inquiries regarding your app.

On this page you can also include optional links for your users to access your Privacy Policy or Support pages.

This is also a good time to upload an optional App Icon for your app. The icon should be a square image between 160px and 400px width and height in GIF/JPG/JPEG/PNG format, and cannot be more than 1MB in size.

Generate App Credentials

In order to allow your app to integrate, the Zoom platform generates a set of unique credentials used to generate the tokens needed to authorize each request.

Clicking ‘View JWT Token’, you’ll see a unique token generated for you by the Zoom Marketplace containing the API Key and API Secret based on the Expiration Time you select below. This token here is intended for temporary usage in development to test how Zoom APIs will retrieve and send information to your account.

There are many methods you might use to generate a JWT within your app, so we recommend referencing our JWT with Zoom guide along with one of the existing JWT.io documentation.

Once you’ve accessed your API Key and Secret and copied over any needed tokens, click Continue.

Note: If you have previously created a JWT app on the Zoom Marketplace, your API Key/Secret will be shared between apps, and can be accessed by logging into Marketplace and clicking Manage.

Add App Features

Event Subscriptions are optional features which allow apps to use Zoom’s webhooks to return information when a certain event or action is triggered. In many cases, Event Subscriptions can replace the need for repeated API calls. For example, you might want to add a feature that sends automated notifications to your app every time a User has activated their account or every time a Recording has started.

To explore or add available Event Subscriptions, click the toggle on. Under ‘Event types,’ click Add events. Here you can see the available actions to fit your use case. If applicable, click subscriptions to add and hit ‘Done’.

To utilize Event Subscriptions, you will need to provide a Destination URL to receive incoming events from Zoom. This could be a URL like ‘https://www.yourcompany.com/user_added’, which we explore in our Webhook guide.

Note: This URL must be secured over HTTPS.

Once you enter your Event types and Destination URL, you must click Save. Once you are completed here, click ‘Continue’.

Activation

Having retrieved your App Credentials and set any Event Subscriptions, your app is all set to make requests to any Zoom APIs. You may want to refer back to any of the above settings to manage your app or if you need to regenerate your API Secrets or tokens.

You also have the option to Deactivate or Reactivate your app. If Deactivated, your app will not be authorized to make requests to Zoom APIs.


Next Steps

For a guide through the process of building a JWT app, continue on to our JWT with Zoom authentication guide, or our JWT Sample App guide.

Need Support?

The first place to look for help is on our Developer Forum, where Zoom Marketplace Developers can ask questions for public answers.

If you can’t find the answer in the Developer Forum or your request requires sensitive information to be relayed, please email us at developersupport@zoom.us.