Top of pageSkip to main content

Create a Webhook-only App

Webhook-only apps allow you to receive near real-time information about specific events that occur in your Zoom account. The event types include account events, app events such as deauthorization of your app, meetings events and more. You can find a list of available event types in our Webhook reference.

By creating a Webhook app on the Zoom App Marketplace, you can subscribe to one or more events for all users in an account. When any of the events you subscribed to occurs, Zoom will send an HTTP POST request payload to your webhook-only app's event notification endpoint URL. For instance, if you subscribe to Meeting > Start Meeting event, you will receive a POST request that contains data about the event each time a meeting starts for a user in your account.

Read the topics below to learn how to receive real-time event data by creating a Webhook-only app in the Zoom App Marketplace.

On This Page

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 Webhook Only as the app type and click on Create.

Provide App Information

The windows that follow will ask you to provide a series of information. All fields are required unless otherwise noted. Descriptions of each field are provided below:

App Name: Provide your app's name here.

Information: In this page, you must provide some basic information about your app including a short description about your app, your company's name and your contact information.

Set App Features

When registering your webhook-only app, you can select the events you want to receive the payloads for by enabling the Event subscription feature in the Feature tab. Event subscriptions allow you to subscribe to interested events and receive Webhook notifications. In many cases, event subscriptions can replace the need for repeated API calls.

To enable event subscriptions, click the Event subscriptions toggle to enable. Enter an optional Subscription name and provide a secure (HTTPS) Event notification endpoint URL. This secure URL will receive POST requests containing data on the notification for each subscribed event.

Next, click Add Events. Select the type of event in the Event types section, then select the events you want to receive. When you are finished, click Done.

Choose event subscriptions to match the needs of your app. For example, you might want to add a feature in your app that sends an automated notification to your app every time a user on your account starts or ends a meeting. To set this up, you must subscribe to Start Meeting and End Meeting events listed under the Meeting event type.

While you can subscribe to as many events as needed for each event subscription, you can only have a maximum of 10 event subscriptions per app. Event subscriptions can also have duplicate events. For example, one Event Subscription could have Meetings and User Events, and a second Event Subscription can have Meetings and Recordings events.

A verification token will be generated in the Feature page after you enable and save the event subscription. This token can be used to validate the POST requests that are sent by Zoom to your event notification endpoint URL.

Under 'Event types,' click Add events. Choose events for which you would like to receive notification for and click Done. Next, click Save.

Activation

After providing all the details mentioned in the steps above, your app will be activated and you will start receiving notifications in your endpoint URL for events that you have subscribed to.

Need help?

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