Skip to content

// crm

Via API

monday CRM email verification with pingutil

monday CRM leads arrive as items from forms, imports and integrations, and the Email column holds whatever was typed. A create_item webhook on the Leads board sends each new item to a small service that verifies the email with pingutil and writes the result to status and text columns with the GraphQL API.

Where it connects: monday.com webhook on the Leads board (create_item event) to a service that updates columns with the change_multiple_column_values mutation

What goes wrong without it

  • Our Leads board has hundreds of items whose emails bounce the moment we send from monday.
  • We cannot sort the board by who is a real company and who signed up with Gmail.
  • Someone has to look up every company by hand to fill in the industry column.

What you can do with monday CRM and pingutil

  • Verify every new lead item

    Write `status` to a text or status column. Board filters and automations can move `invalid` items to a "Bad email" group.

  • Sort by email type

    Write `category` from `/v1/lookup` to a column, so the board can be grouped into company, free, isp and disposable leads.

  • Fill industry and size

    For `company` domains, write `company.industry` and `company.employee_size_estimate` to text columns.

Set it up

  1. 1

    On the Leads board, add text columns "Email status", "Email category" and "Industry", and note their column ids along with the Email column id.

  2. 2

    Deploy the service below with `MONDAY_TOKEN`, `PINGUTIL_KEY` and the column ids.

  3. 3

    Create the webhook with the `create_webhook` mutation (board id, your URL, event `create_item`), or with the board's Webhooks integration in the UI.

  4. 4

    monday sends a `challenge` on registration; the service echoes it back so the webhook is activated.

  5. 5

    Add a board automation that moves items with Email status starting "invalid" to a separate group.

monday create_item webhook receiver
// node >= 18, npm install express
import express from 'express';

const pu = { authorization: 'Bearer ' + process.env.PINGUTIL_KEY, 'content-type': 'application/json' };

async function monday(query, variables) {
  const r = await fetch('https://api.monday.com/v2', {
    method: 'POST',
    headers: { authorization: process.env.MONDAY_TOKEN, 'content-type': 'application/json' },
    body: JSON.stringify({ query, variables }),
  });
  return r.json();
}

const app = express();
app.use(express.json());

app.post('/monday', (req, res) => {
  if (req.body?.challenge) return res.json({ challenge: req.body.challenge }); // registration handshake
  res.sendStatus(200);
  const ev = req.body?.event;
  if (ev?.pulseId) handleItem(ev.boardId, ev.pulseId).catch((e) => console.error(ev.pulseId, e));
});

async function pingutil(path, body) {
  const r = await fetch('https://pingutil.com' + path, {
    method: 'POST', headers: pu, body: JSON.stringify(body), signal: AbortSignal.timeout(30_000),
  });
  return r.ok ? r.json() : null; // fail open on 429 or errors
}

async function handleItem(boardId, itemId) {
  // create_item payloads may not include column values, so read the item.
  const q = await monday('query ($ids: [ID!]) { items(ids: $ids) { column_values { id text } } }', { ids: [String(itemId)] });
  const email = q.data?.items?.[0]?.column_values?.find((c) => c.id === process.env.COL_EMAIL)?.text;
  if (!email) return;

  const [v, l] = await Promise.all([pingutil('/v1/verify', { email }), pingutil('/v1/lookup', { input: email })]);
  const values = {};
  if (v) values[process.env.COL_STATUS] = v.status + ' (' + v.reason + ')';
  if (l) values[process.env.COL_CATEGORY] = l.category;
  if (l?.company?.industry) values[process.env.COL_INDUSTRY] = l.company.industry;
  if (!Object.keys(values).length) return;

  await monday(
    'mutation ($board: ID!, $item: ID!, $vals: JSON!) { change_multiple_column_values(board_id: $board, item_id: $item, column_values: $vals) { id } }',
    { board: String(boardId), item: String(itemId), vals: JSON.stringify(values) },
  );
}

app.listen(process.env.PORT ?? 3000);

What to do with each result

pingutil resultAction in monday CRM
`status: "invalid"`Move the item to a "Bad email" group and keep it out of email automations.
`status: "risky"`Leave in the pipeline, but label for review before mass emails.
`status: "unknown"`Re-check later; the mail server did not answer clearly.
`category: "free"` or `"isp"`Group separately from company leads.
`company.industry`Write to the Industry column for filtering and dashboards.

Limits to plan for

  • monday retries failed webhook deliveries once a minute for 30 minutes, so answer quickly and verify afterwards.
  • The `column_values` argument is a JSON string, not an object; text columns take plain strings, while status columns expect a label object.
  • pingutil allows 300 verified addresses a day (3,000 a month) per account; for an existing board, export emails and verify them in batches of 50. Those are Free plan limits; Enterprise has custom limits.

monday CRM documentation

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

Common questions

Can monday automations call pingutil without a service?
monday can send a webhook when an item is created, but it cannot write pingutil's answer back to the item on its own. A small service like the one above, or an automation tool such as Make or Zapier, does the write-back.
Does updating columns trigger the webhook again?
No. The webhook listens to create_item, and the service only changes column values on an existing item.

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