Skip to content

Create a job

POST /v1/bulk-verifications

The body is optional; name is a label for your own reference.

curl -X POST https://api.tryverifyemail.com/v1/bulk-verifications \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"june-newsletter"}'

const BASE = "https://api.tryverifyemail.com/v1/bulk-verifications";
const headers = {
  Authorization: `Bearer ${process.env.VERIFYEMAIL_API_KEY}`,
  "Content-Type": "application/json",
};

const res = await fetch(BASE, {
  method: "POST",
  headers,
  body: JSON.stringify({ name: "june-newsletter" }),
});
const { id: jobId } = await res.json();

import os, requests

BASE = "https://api.tryverifyemail.com/v1/bulk-verifications"
HEADERS = {"Authorization": f"Bearer {os.environ['VERIFYEMAIL_API_KEY']}"}

res = requests.post(BASE, headers=HEADERS, json={"name": "june-newsletter"})
job_id = res.json()["id"]

Response

Returns 201:

{
  "id": "137eb443-2c6e-4a0f-9b7d-5e1f8a3c2d41",
  "name": "june-newsletter",
  "status": "accepting_input",
  "created_at": "2026-09-05T06:35:00.267Z"
}

See also

Add addresses — the next step
Bulk jobs — overview