Skip to content

// sales engagement and cold email

Via API

Smartlead email verification with pingutil

Smartlead spreads a campaign across many sending inboxes, so one bad list hurts all of them at once. Run each list through pingutil first and push only valid leads to the campaign with the Smartlead API, with catch-all addresses sent to a separate, slower campaign.

Where it connects: Smartlead API, POST /api/v1/campaigns/{campaign_id}/leads (lead_list, up to 400 leads per request)

What goes wrong without it

  • We bought new domains and warmed them for weeks, then one scraped list bounced and took a dozen inboxes down together.
  • Leads get into the campaign before anyone checks them, and Smartlead will not verify them once the campaign is live.
  • Half the list is on catch-all domains and we cannot tell which of those mailboxes actually exist.

What you can do with Smartlead and pingutil

  • Clean the CSV before it becomes a campaign

    Send the list to /v1/verify/batch in chunks of 50, keep the valid rows and push them with lead_list. Invalid rows never reach Smartlead, so they never count against your inboxes.

  • Give catch-all leads their own campaign

    Addresses that come back risky with reason accept_all go into a second campaign on a small set of inboxes and a lower daily limit, so a bad batch costs you less.

  • Verify leads coming from an enrichment tool

    When leads arrive from a scraper or a database export through your own script, verify them in the same script before calling the Smartlead add-leads endpoint.

Set it up

  1. 1

    Create a pingutil API key in the dashboard and copy your Smartlead API key from your Smartlead settings.

  2. 2

    Export the list as a CSV or load it in your script, and collect the email column.

  3. 3

    Call POST https://pingutil.com/v1/verify/batch with up to 50 addresses per call.

  4. 4

    Keep leads with status valid. Put risky / accept_all leads in a separate list, and set unknown leads aside to retry later.

  5. 5

    Post the valid leads to /api/v1/campaigns/{campaign_id}/leads in groups of up to 400, storing the pingutil status in custom_fields.

  6. 6

    Repeat for the catch-all list against a second, lower-volume campaign if you decide to mail it at all.

Verify a list, then add only valid leads to a Smartlead campaign
// Node 18+. PINGUTIL_KEY, SMARTLEAD_API_KEY, CAMPAIGN_ID in env.
type Lead = { email: string; first_name?: string; last_name?: string; company_name?: string };

async function verifyChunk(emails: string[]) {
  const res = await fetch('https://pingutil.com/v1/verify/batch', {
    method: 'POST',
    headers: {
      authorization: 'Bearer ' + process.env.PINGUTIL_KEY,
      'content-type': 'application/json',
    },
    body: JSON.stringify({ emails }),
    signal: AbortSignal.timeout(120_000),
  });
  if (!res.ok) throw new Error('pingutil ' + res.status); // 429 = minute or daily limit
  return (await res.json()).results as { input: string; status: string; reason: string; score: number }[];
}

export async function cleanAndPush(leads: Lead[]) {
  const valid: (Lead & { custom_fields: Record<string, string> })[] = [];
  const catchAll: Lead[] = [];
  const unchecked: Lead[] = [];

  for (let i = 0; i < leads.length; i += 50) {
    const chunk = leads.slice(i, i + 50);
    try {
      const results = await verifyChunk(chunk.map((l) => l.email));
      results.forEach((r, j) => {
        const lead = chunk[j];
        if (r.status === 'valid') valid.push({ ...lead, custom_fields: { pingutil_score: String(r.score) } });
        else if (r.status === 'risky' && r.reason === 'accept_all') catchAll.push(lead);
        else if (r.status === 'unknown') unchecked.push(lead);
        // invalid and other risky results are dropped
      });
    } catch {
      unchecked.push(...chunk); // pingutil error or limit: keep the rows, do not send them blind
    }
  }

  for (let i = 0; i < valid.length; i += 400) {
    const res = await fetch(
      'https://server.smartlead.ai/api/v1/campaigns/' + process.env.CAMPAIGN_ID +
        '/leads?api_key=' + process.env.SMARTLEAD_API_KEY,
      {
        method: 'POST',
        headers: { 'content-type': 'application/json' },
        body: JSON.stringify({ lead_list: valid.slice(i, i + 400) }),
      },
    );
    if (!res.ok) throw new Error('Smartlead ' + res.status);
  }
  return { added: valid.length, catchAll, unchecked };
}

What to do with each result

pingutil resultAction in Smartlead
status: validAdd to the main campaign through lead_list.
status: invalid (mailbox_not_found, no_mx, disposable_domain)Drop the lead. It would only bounce from one of your inboxes.
status: risky, reason: accept_allMove to a separate catch-all campaign with fewer inboxes and a lower daily cap, or skip.
status: unknown (greylisted, timeout, smtp_unavailable)Hold back and verify again later before adding.
did_you_mean is setReview by hand. On a cold list, a corrected address is still a guess, so do not swap it in automatically.

Limits to plan for

  • pingutil verifies 300 addresses per account per day (3,000 a month, API and dashboard CSV combined), so a 2,000-row list takes several days on the Free plan. Over the limit the API returns 429 quota_exceeded. Those are Free plan limits.
  • Smartlead accepts up to 400 leads per add-leads request, and its own help center says leads cannot be verified after a campaign goes live.
  • Catch-all domains accept every address at the SMTP stage, so pingutil reports them as risky / accept_all. No check can confirm those mailboxes.

Smartlead documentation

Smartlead is a trademark of its owner. This integration uses Smartlead's documented extension points; it is not an official Smartlead app.

Common questions

Smartlead has its own verification add-on. Why use pingutil?
Smartlead verification runs inside campaign setup and uses Smartlead credits. pingutil runs before anything reaches Smartlead, gives you a status, reason and score per address, and the same check works for the other tools in your stack. Some teams use one, some use both.
Should I send to catch-all leads at all?
That is a judgment call. Smartlead sends to valid and catch-all leads after its own verification. If you do mail them, keep them in a separate campaign so a high bounce rate there does not spread to your main inboxes.

Stop bad addresses in Smartlead 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 Smartlead setup will receive.