// forms and surveys
Via APITypeform email verification with pingutil
Typeform checks that an email answer looks like an email, not that the mailbox exists, so typos and throwaway addresses flow straight into your CRM and nurture lists. A small webhook receiver verifies the address in each form_response with pingutil and only forwards leads that can actually receive mail. Typeform has no server-side validation step, so this is post-submit filtering: the respondent always sees your ending screen.
Where it connects: Typeform webhooks (form_response event), signed with the Typeform-Signature header
What goes wrong without it
- Our Typeform lead form converts well, but a chunk of the follow-up emails bounce.
- People type gmial.com or hotmial.com on mobile and we never hear from them again.
- Someone fills the quiz with a temp-mail address to see the result, and sales still gets the lead.
What you can do with Typeform and pingutil
Gate CRM sync on a real mailbox
Point the Typeform webhook at your receiver instead of syncing straight to the CRM. Only responses whose email comes back valid or risky are forwarded, with the pingutil status and reason attached as fields.
Recover typos with did_you_mean
When pingutil returns a did_you_mean suggestion, store it next to the original answer so a rep or an automation can send the follow-up to the corrected address.
Keep quiz and giveaway results clean
Flag disposable and randomized addresses on high-volume quiz forms so your reporting counts people, not temp-mail inboxes.
Set it up
- 1
Create a pingutil API key in the dashboard and store it as PINGUTIL_KEY in your server environment.
- 2
Deploy a POST endpoint (the Next.js route below works as-is) that reads the raw body before parsing JSON.
- 3
In Typeform, open the form, go to Connect, then Webhooks, add your endpoint URL and set a secret. Store the same secret as TYPEFORM_SECRET.
- 4
Send a test request from the webhook panel and confirm the signature check passes.
- 5
Set CRM_WEBHOOK_URL to wherever clean leads should go (a CRM inbound webhook, Zapier catch hook or your own API).
- 6
Submit the form with a real and a fake address and compare what reaches the CRM.
import { createHmac, timingSafeEqual } from 'node:crypto';
export const runtime = 'nodejs';
type Answer = { type: string; email?: string; field: { id: string } };
function signatureOk(raw: string, header: string | null): boolean {
if (!header) return false;
const expected =
'sha256=' + createHmac('sha256', process.env.TYPEFORM_SECRET!).update(raw).digest('base64');
const a = Buffer.from(expected);
const b = Buffer.from(header);
return a.length === b.length && timingSafeEqual(a, b);
}
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(8000),
});
return res.ok ? await res.json() : null; // 429 quota_exceeded etc: fail open
} catch {
return null; // timeout or network error: fail open
}
}
export async function POST(req: Request) {
const raw = await req.text();
if (!signatureOk(raw, req.headers.get('typeform-signature'))) {
return new Response('bad signature', { status: 401 });
}
const { form_response } = JSON.parse(raw);
const answer = (form_response.answers ?? []).find((a: Answer) => a.type === 'email');
const email: string | undefined = answer?.email;
if (!email) return new Response('ok'); // optional email question left blank
const result = await verify(email);
const lead = {
email,
typeform_response_id: form_response.token,
email_status: result?.status ?? 'unchecked',
email_reason: result?.reason ?? null,
did_you_mean: result?.did_you_mean ?? null,
};
if (result?.status === 'invalid') {
console.log('typeform lead dropped', lead);
return new Response('ok');
}
await fetch(process.env.CRM_WEBHOOK_URL!, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify(lead),
});
return new Response('ok');
}What to do with each result
| pingutil result | Action in Typeform |
|---|---|
| status: "valid" | Forward the lead to the CRM as normal. |
| status: "invalid" (mailbox_not_found, no_mx, disposable_domain) | Do not forward. Log the response token so you can find it in Typeform Results. |
| status: "risky" (accept_all, role_based) | Forward with email_status set, so the CRM can keep it out of automated sequences until someone replies. |
| status: "unknown" or no result | Forward as unchecked. Re-verify later rather than losing a possibly real lead. |
| did_you_mean is set | Store the suggestion on the lead and send the first follow-up to the corrected address after a human check. |
Limits to plan for
- Typeform has no hook that can reject an answer before submit, so the respondent always completes the form. Filtering happens after the response is saved in Typeform.
- Mailbox checks can take several seconds on slow mail servers. The snippet uses an 8 second timeout and fails open, so a slow check never loses a lead.
- Each verification counts toward your account's 300 verified addresses a day (3,000 a month). Over that, /v1/verify returns 429 quota_exceeded and the snippet forwards the lead unchecked. Those are Free plan limits; Enterprise has custom limits.
Typeform documentation
- www.typeform.com/developers/webhooks/
- www.typeform.com/developers/webhooks/secure-your-webhooks/
- www.typeform.com/developers/webhooks/example-payload/
Typeform is a trademark of its owner. This integration uses Typeform's documented extension points; it is not an official Typeform app.
Common questions
- Can I stop a Typeform from submitting if the email is fake?
- Not from the server. Typeform webhooks fire after the response is recorded. You can filter what reaches your CRM and follow-up emails, which is where bad addresses cost you.
- Where is the email in the Typeform webhook payload?
- In form_response.answers, as an entry with type "email" and the address under the email key. Skipped optional questions are left out of the answers array entirely.
Stop bad addresses in Typeform 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 Typeform setup will receive.