Configure the webhook in the zoom

Once you have configured your SDK credentials, you can set up webhook specifications. You can auto-download Zoom recordings and synchronization of ending sessions.
To configure the webhook specifications, select the Webhook Configuration option.
You will arrive at the webhook page. Here you must enter the Webhook Secret Token.
Now go to the Zoom Marketplace and click on The Develop button. Then select the Build App
Then select the Webhook Only App and click the Create button
Here, enter the developer information like name and email. then click the continue button.
Now go to the Feature and copy the Secret Token
Now, paste it into the Webhook Secret Token space and click the Save button.
Then return to your Zoom account's feature page.
Here, enable Event Subscriptions and click the Add Event Subscription button.
Enter the Subscription name
To enable the auto-download of Zoom recordings, go to your school and copy the Webhook Url For Recordings Auto-Download.
Then paste it here.
Then, click the Authentication Header Option and select Custom header.
Now, go to your school and copy these codes.
Then paste them here correctly.
Once you've pasted them, click the Add Event button.
Click the Recording option and then select the All recordings have completed option. Now, click the Done button.
You have now added the event. Now, click the Validate button.
Once the entered URLs have been validated, click the Save button.
Then Click the Add Event Subscription button again to synchronise the end of sessions.
Enter the Subscription name as end session.
To synchronise the ending sessions, go to your school and copy the Webhook Url For Ending Session.
Then paste it here.
Now go to the school and copy the Custom Header Key and Header Value
Then, click the Authentication Header Option, select the Custom header option, and paste the Custom Header Key and Header Value as before.
Then, click the Add Event button.
Here, click the Meeting option and then select the End Meeting option.
Then click the Webinar option, select the End Webinar option, and the Done button.
You have now added the event. Now, click the Validate button.
Once the entered URLs have been validated, click the Save button.
Now, your Zoom live class recordings will be instantly uploaded to your lessons after you finish your Zoom class.

FAQs

1) Zoom says "URL validation failed" when I add the webhook endpoint. How do I fix it?

Validation fails when the Secret Token in Learnyst doesn't match the one in your Zoom app. Copy the Secret Token from the Zoom app's Feature section, paste it into Learnyst's Webhook Secret Token field, and Save it in Learnyst first — then click Validate in Zoom. If you regenerated the token in Zoom at any point, the old value stored in Learnyst is stale and validation will keep failing until you update it. Also confirm the custom header codes from your Learnyst school settings were copied into the Zoom subscription exactly.

2) My webhooks show as "Unverified" in Zoom — recordings stopped uploading. What does it mean?

An Unverified webhook is one Zoom no longer trusts, and it silently stops delivering events — so recordings stop appearing and sessions stop closing in the admin panel, with no error shown to you. Re-copy the Secret Token into Learnyst, save, and validate the subscription again in Zoom; both subscriptions (recordings and end-session) must show as verified.

3) The recording is in my Zoom account, but it never arrived in the lesson. What should I check, in order?

(3. a) Both event subscriptions exist and are verified — one for recordings, one for end-session.

(3. b) The right events are selected: Recording → All recordings have completed on the recordings subscription, End Meeting and End Webinar on the end-session one.

(3. c) The two URLs are not swapped — the "Recordings Auto-Download" URL and the "Ending Session" URL each belong to their own subscription; swapped, both break with no error.

(3. d) The custom headers are present on both. If everything checks out and it still doesn't arrive, download the recording from Zoom and upload it to the lesson manually while support reviews the configuration.

4) My class ended, but the admin panel still shows the session as live.

That's the second webhook — the "end session" subscription — missing, unverified, or carrying the wrong URL. It's a separate event subscription from the recordings one and must be configured with the End Meeting and End Webinar events.

5) There are two webhook URLs in my school settings. Which goes where?

The Webhook URL for Recordings Auto-Download goes in the subscription with the All recordings have completed event; the Webhook URL for Ending Session goes in the one with End Meeting / End Webinar. Each URL only understands its own events — putting one URL in both subscriptions, or swapping them, silently breaks uploads and session endings.

6) Do I need this Webhook-Only app as well as the Server-to-Server OAuth app?

Yes — they're two different apps doing two different jobs. The Server-to-Server OAuth app gives Learnyst permission to fetch your recordings; the Webhook-Only app is how Zoom tells Learnyst a class ended and a recording is ready. With only the OAuth app configured, recordings won't upload automatically.

7) I regenerated the Secret Token in my Zoom app. Do I need to do anything?

Yes, immediately: paste the new token into Learnyst's Webhook Secret Token field, save, and re-validate both subscriptions in Zoom. The moment you regenerate, the old token is dead and events stop flowing.