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.

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 choose which events you would like to receive payloads for, by enabling Event Subscription features. Event Subscriptions are the core features of a webhook app using which, your app can listen to an event in your Zoom account. In many cases, event subscriptions can replace the need for repeated API calls.

To utilize Event Subscriptions, provide an event notification endpoint URL where you would like to receive the webhook event data in the form of a JSON payload. This could be a URL like ‘https://www.yourcompany.com/meeting_events’.

Note: This URL must be secured over HTTPS.

To explore or add available Event Subscriptions, switch the toggle on.

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.

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.


Next Steps

For a guide through the process of building a Chatbot app, continue on to our Building a Chatbot 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.