Verify Candidate Emails in Your Recruitment & ATS Workflow

import { NextRequest, NextResponse } from "next/server";

const MAILBEAM_KEY = process.env.MAILBEAM_KEY!;

async function verifyEmail(email: string) {
  const res = await fetch("https://api.mailbeam.dev/v1/verify", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${MAILBEAM_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ email }),
  });
  return res.json() as Promise<{
    valid: boolean;
    disposable: boolean;
    score: number;
    status: string;
    suggestion: string | null;
  }>;
}

export async function POST(req: NextRequest) {
  const { email, name, roleId, resumeUrl } = await req.json();

  const check = await verifyEmail(email);

  // A candidate we cannot reach should never enter the ATS as "new"
  if (!check.valid) {
    return NextResponse.json(
      {
        field: "email",
        error: "We couldn't reach this email. Please double-check it so we can send your interview details.",
        suggestion: check.suggestion,
      },
      { status: 422 }
    );
  }

  const application = await ats.applications.create({
    email,
    name,
    roleId,
    resumeUrl,
    emailScore: check.score,
    emailStatus: check.status,
    // Route disposables to a manual screening lane instead of auto-advancing
    stage: check.disposable ? "manual_review" : "new",
  });

  await ats.sendApplicationReceipt(application);
  return NextResponse.json({ applicationId: application.id });
}