# Sinch Email Mailgun Validate

> Validate an email address via Mailgun Validate API

- Skill: `sinch/sinch-email-mailgun-validate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sinch/sinch-email-mailgun-validate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sinch/sinch-email-mailgun-validate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: sinch (https://skillmd.com/u/sinch)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/sinch/sinch-email-mailgun-validate

---


# 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:**

0. If $ARGUMENTS empty: ask for email address to validate. Otherwise parse.

1. 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."

2. GET https://api.mailgun.net/v4/address/validate?address={email} (or api.eu.mailgun.net for EU) with Basic Auth (api:API_KEY).

3. Display result: deliverable/undeliverable, risk, is_disposable_address, is_role_address, reason, did_you_mean. "✅ Validation complete". Handle 401, 400.

4. 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