// support, community and events
Via APIZoom Webinars email verification with pingutil
Webinar registration pages are easy to fill with fake addresses, so registrant counts look healthy, join links bounce and the follow-up sequence goes to nobody. A webinar.registration_created webhook sends each registrant to your endpoint, pingutil verifies the address, and on webinars that use manual approval your code denies disposable registrants through the registrant status endpoint.
Where it connects: Zoom webhook event webinar.registration_created, then the Zoom API update webinar registrant status endpoint (PUT /webinars/{webinarId}/registrants/status)
What goes wrong without it
- The registrant count looked great, the attendee report did not, and marketing had already reported the bigger number.
- Join links go out to addresses that bounce, and the people who typed them never get in.
- Competitors and bots register with temp-mail addresses to grab the recording link.
What you can do with Zoom Webinars and pingutil
Deny throwaway registrants on gated webinars
With manual approval on, disposable registrants are denied and real ones approved, so join links only go to people you can reach.
Auto-approve verified registrants
A valid result can approve the registrant immediately, so manual approval does not slow down real attendees.
Report reachable registrants
Store the status with each registrant and report the count of valid and risky registrations next to the raw total, so attendance rates compare against a real number.
Set it up
- 1
Create a pingutil API key (PINGUTIL_KEY) and a Zoom Server-to-Server OAuth app with webinar registrant write scopes. Webinar events require a Zoom Webinars license.
- 2
In the app's Feature settings, turn on Event Subscriptions, add your endpoint URL and subscribe to the webinar registration created event. Copy the Secret Token.
- 3
Deploy the handler below. It answers the endpoint.url_validation challenge, checks x-zm-signature, then verifies the registrant email after acknowledging.
- 4
Set the webinar to manual approval if you want the code to approve and deny; otherwise keep the results for reporting.
- 5
Register a test address and confirm its status changes in the webinar registrant list.
import express from 'express';
import crypto from 'node:crypto';
const app = express();
const SECRET = process.env.ZOOM_WEBHOOK_SECRET!;
async function verify(email: string) {
try {
const res = await fetch('https://pingutil.com/v1/verify', {
method: 'POST',
headers: { authorization: 'Bearer ' + process.env.PINGUTIL_KEY, 'content-type': 'application/json' },
body: JSON.stringify({ email }),
signal: AbortSignal.timeout(30000),
});
return res.ok ? await res.json() : null; // fail open on 429 / 5xx
} catch {
return null;
}
}
async function zoomToken() {
const basic = Buffer.from(process.env.ZOOM_CLIENT_ID + ':' + process.env.ZOOM_CLIENT_SECRET).toString('base64');
const res = await fetch('https://zoom.us/oauth/token?grant_type=account_credentials&account_id=' + process.env.ZOOM_ACCOUNT_ID, {
method: 'POST',
headers: { authorization: 'Basic ' + basic },
});
return (await res.json()).access_token as string;
}
app.post('/webhooks/zoom', express.raw({ type: 'application/json' }), async (req, res) => {
const raw = req.body.toString('utf8');
const message = 'v0:' + req.get('x-zm-request-timestamp') + ':' + raw;
const expected = 'v0=' + crypto.createHmac('sha256', SECRET).update(message).digest('hex');
if (expected !== req.get('x-zm-signature')) return res.sendStatus(401);
const body = JSON.parse(raw);
if (body.event === 'endpoint.url_validation') {
const plainToken = body.payload.plainToken;
const encryptedToken = crypto.createHmac('sha256', SECRET).update(plainToken).digest('hex');
return res.json({ plainToken, encryptedToken });
}
res.sendStatus(200);
if (body.event !== 'webinar.registration_created') return;
const webinarId = body.payload.object.id;
const registrant = body.payload.object.registrant;
const v = await verify(registrant.email);
if (!v || registrant.status !== 'pending') return; // only act on manual-approval webinars
const action = v.reason === 'disposable_domain' || v.status === 'invalid' ? 'deny' : v.status === 'valid' ? 'approve' : null;
if (!action) return; // risky or unknown: leave for the host
await fetch('https://api.zoom.us/v2/webinars/' + webinarId + '/registrants/status', {
method: 'PUT',
headers: { authorization: 'Bearer ' + (await zoomToken()), 'content-type': 'application/json' },
body: JSON.stringify({ action, registrants: [{ id: registrant.id, email: registrant.email }] }),
});
});
app.listen(3000);What to do with each result
| pingutil result | Action in Zoom Webinars |
|---|---|
| reason: 'disposable_domain' | Deny the registrant so no join link goes out. |
| status: 'invalid' (mailbox_not_found, no_mx) | Deny; the join link would bounce anyway. Keep did_you_mean for a follow-up if you have another channel. |
| status: 'valid' | Approve the registrant immediately. |
| status: 'risky' (accept_all) | Leave pending for the host; corporate catch-all domains are common among real attendees. |
| status: 'unknown' | Leave pending for the host to approve. |
Limits to plan for
- Approve and deny only apply when the webinar uses manual approval; with automatic approval Zoom has already sent the join link.
- Zoom expects the URL validation response within 3 seconds and re-validates the endpoint periodically, so keep that branch fast and always on.
- The registrant status endpoint has its own rate limits, including a per-registrant daily limit, and pingutil verifies up to 300 addresses per account per day (3,000 a month). Those are Free plan limits; Enterprise has custom limits.
Zoom Webinars documentation
Zoom Webinars is a trademark of its owner. This integration uses Zoom Webinars's documented extension points; it is not an official Zoom Webinars app.
Common questions
- Does this work for Zoom Meetings registration too?
- Zoom has matching registration events and a registrant status endpoint for meetings. The handler is the same idea with the meeting event and meeting endpoint swapped in.
- Why not deny risky registrants?
- Many company domains accept all mail, so a real attendee from a large company often comes back risky. Denying them would cost you real leads.
Stop bad addresses in Zoom Webinars today
Sign in with your email, create an API key and paste it into the step above. Test on a few real addresses first: the live demo shows exactly what your Zoom Webinars setup will receive.