// support, community and events
Via APICalendly email verification with pingutil
A public Calendly link lets anyone book your time, and bookings made with throwaway or mistyped addresses turn into no-shows that never got the invite. An invitee.created webhook sends every booking to your endpoint, pingutil verifies the invitee email, and your code cancels bookings from disposable or dead addresses and tells the host about the borderline ones.
Where it connects: Calendly webhook subscription on invitee.created, then the Calendly API cancel event endpoint (POST /scheduled_events/{uuid}/cancellation)
What goes wrong without it
- Our demo calendar is full of bookings from fake emails, and the sales rep sits on an empty call.
- Someone booked with jon@gmial.com, never got the invite, and then emailed asking why we stood them up.
- We have no way to tell a real prospect from a throwaway until the meeting starts.
What you can do with Calendly and pingutil
Cancel bookings from throwaway addresses
When the invitee email is on a disposable domain or the mailbox does not exist, cancel the scheduled event with a reason, which frees the slot for a real prospect.
Warn the host about typos
An invalid result with did_you_mean goes to the host so they can send the meeting link to the corrected address instead of losing the call.
Prioritize work-email bookings
A /v1/lookup on the invitee gives category and, for company domains, a company profile the rep can read before the call.
Set it up
- 1
Create a pingutil API key (PINGUTIL_KEY) and a Calendly personal access token (CALENDLY_TOKEN). Webhook subscriptions need a paid Calendly plan.
- 2
Create the subscription with the Calendly API: POST to /webhook_subscriptions with your URL, events ["invitee.created"], your organization URI, scope and a signing_key you choose.
- 3
Deploy the handler below. It checks the Calendly-Webhook-Signature header (HMAC-SHA256 of timestamp, a period and the raw body), answers 200, then verifies payload.email.
- 4
For disposable or invalid results, the handler cancels the event through the scheduled event cancellation endpoint with a reason.
- 5
Book a test slot with a disposable address and confirm the event is canceled.
import express from 'express';
import crypto from 'node:crypto';
const app = express();
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;
}
}
app.post('/webhooks/calendly', express.raw({ type: 'application/json' }), async (req, res) => {
const header = req.get('Calendly-Webhook-Signature') ?? '';
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=') as [string, string]));
const expected = crypto.createHmac('sha256', process.env.CALENDLY_SIGNING_KEY!).update(parts.t + '.' + req.body.toString('utf8')).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 180;
if (expected !== parts.v1 || !fresh) return res.sendStatus(401);
res.sendStatus(200);
const body = JSON.parse(req.body.toString('utf8'));
if (body.event !== 'invitee.created') return;
const { email, name, scheduled_event } = body.payload;
const v = await verify(email);
if (!v) return; // pingutil unavailable: keep the booking
if (v.reason === 'disposable_domain' || (v.status === 'invalid' && !v.did_you_mean)) {
await fetch(scheduled_event.uri + '/cancellation', {
method: 'POST',
headers: { authorization: 'Bearer ' + process.env.CALENDLY_TOKEN, 'content-type': 'application/json' },
body: JSON.stringify({ reason: 'We could not verify the email address used for this booking. Please book again with a working address.' }),
});
return;
}
if (v.status === 'invalid' || v.status === 'risky') {
// Tell the host; replace with Slack, email or a CRM note
console.log(JSON.stringify({ meeting: scheduled_event.uri, invitee: name, email, status: v.status, reason: v.reason, did_you_mean: v.did_you_mean }));
}
});
app.listen(3000);What to do with each result
| pingutil result | Action in Calendly |
|---|---|
| reason: 'disposable_domain' | Cancel the scheduled event with a reason; the slot opens up again. |
| status: 'invalid' without did_you_mean | Cancel; the invite and reminders cannot be delivered. |
| status: 'invalid' with did_you_mean | Keep the booking and send the host the suggested address so they can forward the invite. |
| status: 'risky' | Keep the booking and flag it to the host. |
| status: 'valid' or 'unknown' | No action. |
Limits to plan for
- Webhook subscriptions require a paid Calendly plan and are created through the API, not the Calendly UI.
- Canceling sends the invitee a cancellation notice (and fires invitee.canceled), so only cancel on clear results; a canceled real prospect is worse than one empty call.
- Each booking costs one verification from the 300 per day account default (3,000 a month), and catch-all company domains return risky rather than valid. Those are Free plan limits; Enterprise has custom limits.
Calendly documentation
- developer.calendly.com/receive-data-from-scheduled-events-in-real-time-with-webhook-subscriptions
- developer.calendly.com/api-docs/overview/webhooks/webhook-signatures
Calendly is a trademark of its owner. This integration uses Calendly's documented extension points; it is not an official Calendly app.
Common questions
- Can pingutil stop the booking before it is made?
- Not on a standard Calendly booking page; the webhook fires after the invitee books. If you embed Calendly behind your own form, you can verify the email on your form first and only show the scheduler for addresses that pass.
- Why keep bookings with a typo suggestion?
- A did_you_mean result usually means a real person who mistyped. Fixing the address keeps the meeting; canceling would lose them.
Stop bad addresses in Calendly 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 Calendly setup will receive.