Check Email Address
mailcheck.check_email
ActionEmailconnection required
Calls the Mailcheck API with the connection's credentials.
Check one email address and wait for its risk verdict.
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.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
email The email address to check, usually taken from an upstream step. | string | Yes | — | email format | jane@example.com |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"email": "jane@example.com"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
email The address that was checked, as Mailcheck echoed it. | string | — |
trustRate Mailcheck's confidence that the address is real, from 0 to 100. | number | — |
mxExists True when the domain publishes MX records. | boolean | — |
smtpExists True when the mailbox answered the SMTP probe. | boolean | — |
isNotSmtpCatchAll Reads negatively: false means the domain accepts every address. | boolean | — |
isNotDisposable Reads negatively: false means the address is a disposable one. | boolean | — |
gravatar Gravatar profiles found for the address, if any. | object | — |
githubUsername GitHub username found for the address, if any. | string | — |
facebook Facebook profile found for the address, if any. | object | — |
{
"email": "",
"facebook": {},
"githubUsername": "",
"gravatar": {},
"isNotDisposable": false,
"isNotSmtpCatchAll": false,
"mxExists": false,
"smtpExists": false,
"trustRate": 0
}Notes
- This call spends one verification credit and blocks until Mailcheck answers; use mailcheck.check_emails for a whole list.
Related Mailcheck nodes
See Check Email Address 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.