Mailgun

Mailgun

Email delivery infrastructure for transactional and marketing email. Full domain management, delivery event tracking, bounce/complaint monitoring, and aggregate stats.

Regions

Mailgun splits EU and US infrastructure; your connection targets one region with the matching API host.

Capability areas

Domain management

• Domain directory — all sending domains with state (active/unverified/disabled) and type. Resolve domain names here before deeper reads.
• Domain detail — DNS records (SPF, DKIM, MX, CNAME), verification state, and configuration for a specific domain.

Event monitoring (all require domain)

• Event stream — timestamped delivery events: accepted, delivered, failed, opened, clicked, unsubscribed, complained, stored. Filter by event type. Best for delivery troubleshooting.
• Aggregate stats — event counts for a domain over a time period; suited to delivery-rate dashboards.

Deliverability (all require domain)

• Bounces — permanently failed addresses with SMTP error codes. Clean these from your lists.
• Complaints — addresses that marked your email as spam. High rates damage sender reputation.

Workflows

• Domain health check: enumerate domains → open domain detail for DNS → pull aggregate stats for delivery rates.
• Delivery debugging: scan failed events → read SMTP error codes and failure reasons.
• List hygiene: combine bounces and complaints → remove bad addresses from your sending lists.
• Engagement tracking: filter opened/clicked events → measure recipient engagement.

Gotchas

• Domain is required: events, stats, bounces, and complaints are all scoped to a specific domain. Enumerate domains first to get valid domain names.
• Events retained 3 days: Mailgun only stores event data for ~3 days. Query promptly.
• Event limit: max 300 events per request. Use pagination for full history.