No-code recipes
Zapier, Make, n8n and Google Sheets can all call the API through their HTTP request steps. The recipe is the same everywhere: POST to https://api.email-validation.org/v1/validate with a JSON body, the API key in the Authorization header, and the JSON answer mapped into later steps. Never paste the key into a URL or a query parameter: such requests are refused.
| Setting | Value |
|---|---|
| Method | POST |
| URL | https://api.email-validation.org/v1/validate |
| Header | Authorization: Bearer ev_live_… |
| Header | Content-Type: application/json |
| Body (JSON) | {"email": "<the address from an earlier step>"} |
| Fields to use | status, reason, action, did_you_mean, credits_used |
Use a dedicated API key for each tool, with a daily credit cap, so a looping automation cannot spend more than you expect. Test with accepted@sandbox.email-validation.org and the other test addresses: they are free.
Zapier
- Add an action step with the Webhooks by Zapier app and choose Custom Request (or POST).
- Method
POST, URLhttps://api.email-validation.org/v1/validate. - Data:
{"email": "…"}, inserting the email field from your trigger. - Headers:
Authorization=Bearer ev_live_…andContent-Type=application/json. - Test the step, then use the returned
statusandactionin a Filter or Paths step, for example "only continue whenstatusisdeliverable".
Make
- Add the HTTP app's Make a request module.
- URL
https://api.email-validation.org/v1/validate, methodPOST. - Headers:
Authorization=Bearer ev_live_…. - Body type Raw, content type JSON (application/json), request content
{"email": "…"}with the address mapped in. - Turn on Parse response so
status,reasonandactioncan be mapped in later modules or a router filter.
n8n
- Add an HTTP Request node with method
POSTand URLhttps://api.email-validation.org/v1/validate. - Authentication: Generic Credential Type → Header Auth, with name
Authorizationand valueBearer ev_live_…. Storing the key as a credential keeps it out of the workflow itself. - Send Body: JSON, with a field
emailset to an expression such as{{ $json.email }}. - Follow with an If or Switch node on
statusoraction.
Google Sheets
Spreadsheet formulas cannot send an Authorization header, so use a small Apps Script that runs from a menu and writes the results next to your addresses.
- In your sheet, open Extensions → Apps Script and paste the script below.
- Under Project Settings → Script properties, add
EV_API_KEYwith your key. It stays out of the sheet. - Reload the sheet, select the cells with addresses, and choose Email validation → Validate selected cells. Status, reason and action appear in the three columns to the right.
const API_URL = 'https://api.email-validation.org/v1/validate';
function onOpen() {
SpreadsheetApp.getUi()
.createMenu('Email validation')
.addItem('Validate selected cells', 'validateSelection')
.addToUi();
}
function validateSelection() {
const key = PropertiesService.getScriptProperties().getProperty('EV_API_KEY');
if (!key) throw new Error('Add EV_API_KEY under Project Settings > Script properties.');
const range = SpreadsheetApp.getActiveRange();
const rows = range.getValues().map(([email]) => {
if (!email) return ['', '', ''];
const res = UrlFetchApp.fetch(API_URL, {
method: 'post',
contentType: 'application/json',
headers: { Authorization: 'Bearer ' + key },
payload: JSON.stringify({ email: String(email).trim() }),
muteHttpExceptions: true,
});
const body = JSON.parse(res.getContentText());
if (res.getResponseCode() !== 200) return ['error', body.error.code, ''];
return [body.status, body.reason, body.action];
});
range.offset(0, 1, rows.length, 3).setValues(rows);
}Run it from the menu rather than as a cell formula: formulas recalculate often, and each recalculation would check (and pay for) the addresses again. Apps Script also limits how long a run may take and how many requests a day it may send, so for long lists upload the file as a bulk job instead.
Bulk lists from automations
For lists, send one request to POST https://api.email-validation.org/v1/bulk with {"emails": [...]} (up to 100,000 addresses), then poll GET https://api.email-validation.org/v1/bulk/{id} or receive a webhook when the job is done. See the bulk jobs API.