Validate Email Address (Mailgun)
Validate a single email address or run bulk validation using the Mailgun Validate API. Returns deliverability, risk, disposable/role detection. Uses Basic Auth (api:API_KEY).
IMPORTANT: Execute this command directly. Do NOT generate script files. Perform the API call immediately.
Input
--address/-a: Email address to validate - required--format/-f: Output format (table or json) - optional
Arguments: $ARGUMENTS
Instructions
Execute these steps directly - do not write code or scripts:
If $ARGUMENTS empty: ask for email address to validate. Otherwise parse.
Validate: --address (valid email format). Get MAILGUN_API_KEY. Base: api.mailgun.net or api.eu.mailgun.net per MAILGUN_REGION. If missing, report "Mailgun is not configured. Set MAILGUN_API_KEY."
GET https://api.mailgun.net/v4/address/validate?address={email} (or api.eu.mailgun.net for EU) with Basic Auth (api:API_KEY).
Display result: deliverable/undeliverable, risk, is_disposable_address, is_role_address, reason, did_you_mean. "✅ Validation complete". Handle 401, 400.
Handle all errors gracefully.
Examples
/sinch-email-mailgun-validate --address=user@example.com
/sinch-email-mailgun-validate -a test@example.com --format=json
API Reference
- Endpoint: GET /v4/address/validate?address={email}
- Auth: Basic api:API_KEY