About this plugin
SwiftTrap is a drop-in replacement for wp_mail() that routes WordPress email through the Mailtrap Email Sending API instead of SMTP. It is purpose-built for Mailtrap — not a generic SMTP plugin with a Mailtrap preset — so it exposes Mailtrap-native features that SMTP cannot: bulk vs transactional stream routing, email categories, custom variables for tracking, suppression lists, and domain verification status.
Why HTTP API instead of SMTP?
- Lower latency — one HTTPS call per message, no MAIL FROM / RCPT TO / DATA round-trips.
- Better deliverability — Mailtrap routes API messages through its dedicated transactional and bulk streams; SMTP doesn’t expose stream selection.
- Native categories — every email is automatically categorized (welcome, password-reset, notification, marketing, etc.) so you can filter and report on them in Mailtrap.
- No firewall headaches — port 587/465 blocked? API works over standard HTTPS 443.
Why SwiftTrap and not WP Mail SMTP / Post SMTP
- Generic SMTP plugins use Mailtrap’s SMTP credentials and lose every Mailtrap-only feature.
- SwiftTrap calls send.api.mailtrap.io for transactional mail and bulk.api.mailtrap.io for bulk mail — automatically, based on category or via filter.
- No Mailtrap PHP SDK required. Plugin is ~30 KB total and uses only the WordPress HTTP API ( wp_remote_post ).
- Stats page shows your sending domain verification status and the live suppression list (bounces, complaints, unsubscribes).
Features
- Drop-in replacement for wp_mail() — works with WooCommerce, Contact Form 7, Gravity Forms, and any plugin that uses WordPress mail.
- Automatic email categorization and stream routing overrides via settings grid.
- Delivery Tracking & Webhooks — Real-time event tracking via custom REST route swifttrap/v1/webhook.
- Suppression Management — CRUD panel for Mailtrap suppression lists with pre-send recipient suppression checks.
- Reliability Fallback — Graceful failover back to WordPress native wp_mail() if the Mailtrap API call fails.
- Site Health integration — Verification test checking Mailtrap token status and sending domain verification.
- Live Email Log — Browse and filter delivery data pulled directly from the Mailtrap API; search by recipient address, status, or date range with automatic pagination.
- WP-CLI commands — Command-line management via wp swifttrap (test, stats, prune-logs, send-suppression-sync).
- Attachment size guard — Configurable limits to prevent oversized files from rejecting at the API gateway.
- Test email button on the settings page.
- Mailtrap template support via template_uuid.
- Falls back to default WordPress mail handler when disabled or token is empty.
Extensible via filters
- swifttrap_mailtrap_email_category — override the auto-detected email category.
- swifttrap_mailtrap_use_bulk_stream — force a message into the bulk or transactional stream.
- swifttrap_mailtrap_template — send via a Mailtrap template by template_uuid.
- swifttrap_mailtrap_custom_variables — attach tracking metadata to outgoing emails.
Privacy
io. io/api/email_logs. See the Mailtrap Privacy Policy.
No data is sent anywhere else.