Mailgun API
SMS & Messaging · Email
Mailgun is a developer-focused transactional email API service that enables applications to send, receive, and track emails through a clean REST API or SMTP relay. Originally founded in 2010 and acquired by Sinch in 2021, Mailgun has built a reputation as the go-to email API for developers who value detailed logs, powerful inbound routing, and a separate email validation product that works hand-in-hand with the sending API.
Mailgun API Highlights
Mailgun API is verified for developer integrations in Nigeria and across African markets, providing documented endpoints, sandbox testing, and developer support.
API Key (HTTP Basic Auth)
Free: 100/day. Paid plans scale per tier.
Nigeria
Ghana
Kenya
AWSMailgun API is best for:
Developers needing reliable transactional email with powerful email validation, inbound routing, and detailed logs. Developer-focused platform with strong API and excellent email analytics.
- Free trial:100 emails/day for 3 months
- Paid from $15/month (50,000 emails)
- Nigeria supported
Mailgun API Core Features & Capabilities
Features Included
Not Supported
Mailgun API Supported Webhook Events
HTTP POST requests containing timestamp, token, and signature fields signed via HMAC-SHA256 with your Webhook signing key.
| Event Name | Trigger & Description |
|---|---|
delivered | Email was accepted by the recipient mail server. |
opened | Recipient opened the email message. |
clicked | Recipient clicked a link inside the message. |
permanent_fail | Message permanently failed delivery. |
temporary_fail | Temporary delivery delay; delivery will be retried. |
unsubscribed | Recipient unsubscribed from email list. |
complained | Recipient filed a spam complaint. |
Required Access Documents for Mailgun API
- Mailgun AccountRequiredRegister at mailgun.com. Free trial requires credit card for verification. Domain authentication (DNS records: SPF, DKIM, DMARC) required before sending to real addresses. API key from dashboard.
Different Mailgun API use cases
- Transactional Email for Nigerian Platform:Use Mailgun to send OTP emails, order confirmations, and account alerts from a Nigerian application with high deliverability, detailed per-email logs showing exactly what happened to each message.
- Email Validation Before Sending:Use Mailgun's Email Validation API to validate Nigerian users' email addresses at registration checking syntax, domain existence, and mailbox validity before sending welcome emails, reducing bounces.
- Inbound Email Processing for Nigerian App:Use Mailgun's inbound routing to receive and parse emails sent to your domain, forwarding parsed content (sender, subject, body, attachments) to a webhook in your Nigerian application for automated processing.
- Developer Testing with Sandbox Domain:Use Mailgun's sandbox domain to test email sending during development of a Nigerian application without authenticating a real domain, allowing full API integration testing before production deployment.