Skip to content

// e-commerce and billing

Via API

Gumroad email verification with pingutil

Gumroad delivers the product to the email the buyer typed, and pay-what-you-want and free products attract throwaway inboxes that later bounce your launch emails. Pointing Gumroad Ping at a small endpoint that verifies each sale email with pingutil lets you spot typos for support and keep disposable addresses out of your mailing list.

Where it connects: Gumroad Ping (sale notification POST) or a sale resource subscription through the Gumroad API

What goes wrong without it

  • Someone bought the course, typed the email wrong and now thinks we scammed them.
  • Our free lead-magnet products are full of temp-mail addresses that bounce when we announce the paid version.
  • We export Gumroad customers into our newsletter tool and the bounce rate on the first send is ugly.

What you can do with Gumroad and pingutil

  • Spot buyers who will never get the product

    For each sale, verify the email. Invalid results and did_you_mean suggestions go to a support inbox so you can reach the buyer another way.

  • Keep throwaways out of your list

    Before adding a buyer to your newsletter or email platform, drop addresses that are disposable or invalid.

  • Measure lead-magnet quality

    Count how many free-product downloads come from disposable domains, so you know whether to require a real address or change the offer.

Set it up

  1. 1

    Create an API key in the pingutil dashboard and store it as PINGUTIL_KEY.

  2. 2

    Deploy an HTTPS endpoint that accepts form-encoded POSTs, with a long random token in its URL because Ping requests are not signed.

  3. 3

    Enter that URL as the Ping endpoint in your Gumroad settings, or subscribe it to the sale resource through the API.

  4. 4

    In the handler, respond 200, then verify the email field with pingutil.

  5. 5

    Forward the result to your support inbox, newsletter tool or database.

Ping endpoint (form-encoded sale notification)
import express from 'express';

const app = express();

app.post('/webhooks/gumroad/:token', express.urlencoded({ extended: false }), (req, res) => {
  if (req.params.token !== process.env.GUMROAD_PING_TOKEN) return res.sendStatus(404);
  res.sendStatus(200); // Gumroad retries non-200 responses

  const { email, sale_id, product_name } = req.body;
  if (email) checkSale(sale_id, product_name, email).catch(console.error);
});

async function checkSale(saleId, productName, email) {
  let result;
  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),
    });
    if (!res.ok) return; // fail open
    result = await res.json();
  } catch {
    return;
  }

  if (result.status === 'invalid' || result.did_you_mean) {
    await notifySupport('Sale ' + saleId + ' (' + productName + '): ' + email + ' is ' + result.status +
      (result.did_you_mean ? ', maybe ' + result.did_you_mean : ''));
  }
  if (result.status !== 'invalid' && !result.checks.disposable) {
    await addToNewsletter(email); // your email platform call
  }
}

app.listen(3000);

What to do with each result

pingutil resultAction in Gumroad
status: "invalid"Alert support so they can reach the buyer another way, and keep the address off your list.
did_you_mean is setSend the suggestion to support to confirm with the buyer.
checks.disposable: trueDo not add to your newsletter. Count it in your lead-magnet quality numbers.
status: "valid" or "risky"Add to your list as normal. Risky usually means a catch-all domain.

Limits to plan for

  • Gumroad Ping requests are not signed, so protect the endpoint with a secret token in the URL and treat the payload as a notification, not proof of payment.
  • Gumroad retries a Ping that does not get a 200 once an hour for up to three hours, so respond first and make processing idempotent on sale_id.
  • The check runs after the sale. Gumroad hosts the checkout, so there is no place to show a typo suggestion before the buyer pays.

Gumroad documentation

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

Common questions

Ping or resource subscriptions?
Ping is one URL set in your settings and is the quickest start. Resource subscriptions are created through the API and let you register endpoints for specific resources such as sale.
Can I verify my existing Gumroad customer list?
Yes. Export customers to CSV and upload it in the pingutil dashboard (50 rows per upload), or send them through /v1/verify/batch in groups of 50.

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