Book a demo

Check Email Addresses In Bulk

mailcheck.check_emails
ActionEmailconnection required

Calls the Mailcheck API with the connection's credentials.

Start a batch check over many addresses; the result arrives later.

Ask about MailcheckAll Mailcheck nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Mailcheck
Secret shape
the API key, or {"api_key": "…"}
Resolved by
config.connection_id, else node.connection_id

Configuration

1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
emails
The addresses to check, as a JSON array or a comma-separated list.
arrayYes—≥ 1 characters; array of string["jane@example.com","john@example.com"]

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "emails": [
    "jane@example.com",
    "john@example.com"
  ]
}

Output

One shape.

result

FieldTypeExample
name
The operation's name, which identifies it in later calls.
string—
done
True once every address in the batch has been processed.
boolean—
total_count
How many addresses the batch carries in total.
number—
processed_count
How many addresses have been checked so far.
number—
free_limit_reached
True when the account's free verification allowance stopped the batch.
boolean—
create_time
When the batch was started, as an ISO-8601 timestamp.
string—
result_url
URL the finished results can be downloaded from; empty until done is true.
string—
error_message
Mailcheck's message when the batch failed; empty when it did not.
string—
operation
Mailcheck's own operation object, exactly as returned.
object—
requested_count
How many addresses this node sent.
number—
{
  "create_time": "",
  "done": false,
  "error_message": "",
  "free_limit_reached": false,
  "name": "",
  "operation": {},
  "processed_count": 0,
  "requested_count": 0,
  "result_url": "",
  "total_count": 0
}

Notes

  • The batch runs asynchronously: poll mailcheck.get_operation with the returned name until 'done' is true, then read 'result_url'.

Related Mailcheck nodes

See Check Email Addresses In Bulk run in a workflow.

In a technical demo we add the Mailcheck connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales