Validate Address
mailgun.validate_address
ActionEmailconnection required
Calls the Mailgun API with the connection's credentials.
Check one email address with Mailgun's validation service and return its deliverability result, risk rating and any suggested correction.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Username & password
- Providers
- Mailgun
- Secret shape
- the private API key: {"username": "api", "password": "…"}, or {"api_key": "…"}, or the raw key
- Config it needs
- domain, region, from_email, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
2 fields, 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 |
|---|---|---|---|---|---|
address The email address to validate. | string | Yes | — | — | — |
provider_lookup Let Mailgun query the mailbox provider; turn off for a faster, syntax-only answer. | boolean | No | true | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"provider_lookup": true
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
address The address that was validated. | string | — |
result deliverable, undeliverable, do_not_send, catch_all or unknown. | string | — |
risk Mailgun's reputation risk rating for the address. | string | — |
reason Why Mailgun reached that result. | array | — |
did_you_mean A suggested correction when a typo is likely. | string | — |
is_disposable_address True for a throwaway mailbox. | boolean | — |
is_role_address True for a role account such as info@. | boolean | — |
{
"address": "",
"did_you_mean": "",
"is_disposable_address": false,
"is_role_address": false,
"reason": [],
"result": "",
"risk": ""
}See Validate Address run in a workflow.
In a technical demo we add the Mailgun connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.