SwiftTrap for Mailtrap

Description

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.
• Advanced Admin Log — Search and filter logs, view rendered HTML/text bodies in modals, and manual email resend capability.
• CSV Export — Download complete email logs directly from the dashboard.
• 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

This plugin sends email payloads (recipients, subject, body, attachments) to the Mailtrap API at send.api.mailtrap.io and bulk.api.mailtrap.io. Account stats are fetched from mailtrap.io/api/accounts. See the Mailtrap Privacy Policy. No data is sent anywhere else.