How-to guides

Common workflows

Upload and preview a list

Upload a CSV from Bulk Scans, run the free list preview, then start a full clean when you are ready to export segments.

Validate a single email

Use Quick Validate on the dashboard or the trial page for clear send guidance.

Generate an API key

Open API Keys to generate a live key. Keys are created server-side and shown there to copy; rotate anytime. Send it as Authorization: Bearer va_live_... on API calls.

Configure webhooks

Set a webhook URL under API Keys to receive validation.completed events for API-initiated jobs (full result for single checks, summary + job id for batch). Verify the X-Validationapp-Signature header with your signing secret.

Export and segment results

From a completed job, download CSV segments: the full report, "safe to send" (best reach), or "safe + cautious" (max reach). For verification jobs you can also filter to a single provider such as Gmail.

Manage your subscription

In Billing you can switch plans (effective next renewal), cancel at period end, resume a pending cancellation before the period ends, or retry a past-due payment.

Track usage with Analytics

Open Analytics to see deliverability and threat outcomes, in-flight jobs, and per-job breakdowns. Filter by validation type to understand how credits are being spent.

Full endpoint details are in the API reference.