Skip to main content

Zoom Webhooks

Pro PlusEvents Manager Zoom ProRequires an Events Manager Pro Plus license. Compare plans

Webhooks are part of Events Manager Zoom Pro. Zoom notifies your site the moment something happens on Zoom, and Events Manager updates your bookings to match.

Webhooks are optional. Without them, attendance and recordings are still fetched from Zoom after each event, usually within the hour. Set up webhooks if you want them straight away, or if you want bookings canceled when a registration is canceled on Zoom.

What webhooks do​

  • Cancellations: when a registrant cancels their Zoom registration, the matching booking is canceled in Events Manager. With attendee forms, the attendee is marked as canceled, and the booking is canceled once every attendee has canceled.
  • Attendance (needs Events Manager Pro): attendees are checked in the moment they join the meeting and checked out when they leave, rather than after the event.
  • Recordings: the Watch the recording button appears as soon as Zoom has processed the recording.

Each of these can be switched off separately in the settings: Cancel bookings cancelled on Zoom under Webhooks, and Record attendance and Share cloud recordings under Attendance and Recordings.

Setting it up​

  1. In WordPress, go to Events then Settings then General then Zoom. Copy the webhook URL shown under Webhooks.

  2. Sign in to the Zoom App Marketplace and open your app.

  3. Go to Features > Access. Copy the Secret token from the Token section into the Secret Token field in WordPress and save your settings.

  4. Back on Zoom, under General features, switch on Event subscription and click Add new event subscription. Give it a name, keep Webhook as the method, and keep All users in your account as the receiver.

  5. Click Add events and tick these:

    • Meeting: Meeting Registration has been canceled, Participant/Host joined meeting, Participant/Host left meeting, End Meeting
    • Webinar: the matching registration canceled, participant joined, participant left and webinar ended events
    • Recording: All Recordings have completed

    In Zoom's API documentation these are meeting.registration_cancelled, meeting.participant_joined, meeting.participant_left, meeting.ended, the same four for webinar, and recording.completed.

    Adding these events also adds the scopes Zoom needs to send them to your app, such as meeting:read:participant:admin and cloud_recording:read:recording:admin.

  6. Paste the webhook URL as the Event notification endpoint URL and save the subscription.

  7. In WordPress, disconnect your Zoom account in the Zoom settings and connect it again. Zoom only sends notifications that your connection allows, and the connection you made before adding the subscription doesn't include the new scopes, so until you reconnect Zoom sends your site nothing.

Your site needs to be reachable from the internet over HTTPS with a certificate from a recognized authority, so webhooks won't work on a local development site. Zoom checks the endpoint again every 72 hours and switches the subscription off after six failed checks in a row.

Placeholders​

The recording and attendance placeholders are listed on Zoom Attendance and Recordings.

Troubleshooting​

If no notifications arrive at all, disconnect and reconnect your Zoom account in WordPress (step 7 above). Otherwise, check that the Secret Token in WordPress matches the one on Zoom exactly, and that a security plugin or firewall isn't blocking requests to your site's REST API. Zoom retries failed notifications three times over about an hour.