MagicDX

Theme

Magic-Mail ​

strapi-plugin-magic-maillatestLicenseMITStrapiv5GitHub

At a glance ​

6 Providers

Gmail, Microsoft 365, Yahoo (all OAuth 2.0), plus SMTP, SendGrid, and Mailgun APIs.

Smart Routing

Route emails by type, recipient domain, subject, or custom fields. Per-rule failover chains.

Learn more

Automatic Failover

When an account hits a rate limit, Magic-Mail automatically falls back to the next account.

Visual Designer

Drag-and-drop email builder with Mustache variables and version history (Premium).

GDPR Compliant

List-Unsubscribe headers added automatically for marketing emails. One-click unsubscribe.

Encrypted at Rest

All credentials (OAuth tokens, SMTP passwords, API keys) encrypted with AES-256-GCM.

Quick install ​

bash
npm install strapi-plugin-magic-mail
typescript
// config/plugins.ts
export default () => ({
  'magic-mail': { enabled: true },
});
bash
npm run build && npm run develop

Open Admin → Magic-Mail → Email Accounts, click Add Account, choose a provider, authenticate, test. Done.

Full installation guide

How Magic-Mail fits in ​

Magic-Mail transparently intercepts Strapi's built-in email service. Any plugin or controller that calls strapi.plugin('email').service('email').send(...) is automatically routed through Magic-Mail's provider selection, rate-limit tracking, and failover logic. You don't need to rewrite existing code.

js
// This call goes through Magic-Mail automatically
await strapi.plugin('email').service('email').send({
  to: 'user@example.com',
  subject: 'Welcome',
  html: '<h1>Hello!</h1>',
  type: 'transactional',  // Optional: used by routing rules
});

For direct control you can also call the Magic-Mail service:

js
await strapi.plugin('magic-mail').service('email-router').send({
  to: 'customer@example.com',
  subject: 'Order Confirmation',
  html: '<h1>Order #12345</h1>',
  accountName: 'SendGrid Marketing',  // Force a specific account
});

API reference

Supported providers ​

ProviderAuthAPIAttachmentsDocs
GmailOAuth 2.0Gmail APIYesProviders →
Microsoft 365OAuth 2.0 (Azure AD)Graph APIYesProviders →
Yahoo MailOAuth 2.0SMTP-OAuth2YesProviders →
SMTPUsername / PasswordSMTPYesProviders →
SendGridAPI KeySendGrid APIEncodedProviders →
MailgunAPI KeyMailgun APILimitedProviders →

Security ​

  • AES-256-GCM encryption for all stored credentials (OAuth tokens, SMTP passwords, API keys)
  • TLS 1.2+ enforced for SMTP connections with certificate verification
  • HTTPS only for API providers (SendGrid, Mailgun)
  • Secure OAuth 2.0 flows with state verification
  • DKIM signing automatic for OAuth providers, optional for SMTP
  • GDPR List-Unsubscribe and List-Unsubscribe-Post headers included automatically
  • CAN-SPAM one-click unsubscribe support
  • RFC 5322 email format validation before sending

Generate a production encryption key:

bash
openssl rand -hex 32
# Add the result as MAGIC_MAIL_ENCRYPTION_KEY in your .env

Pricing ​

FeatureFreePremiumAdvanced
Email accounts3UnlimitedUnlimited
All 6 providers✓✓✓
Smart routing✓✓✓
Automatic failover✓✓✓
Templates25100500
Version history—✓✓
Analytics—BasicAdvanced
A/B testing——✓
Import/export——✓
Priority support——✓
Price$0$14.50/month$39.50/month

View all pricing details →

Next steps ​

Installation

Step-by-step setup for each provider and configuration options.

Get started

Smart Routing

Build rules that pick the right account for every outgoing email.

Learn routing

API Reference

All methods, parameters, and return types for server-side use.

View API

Examples

Recipes for common patterns: transactional, marketing, multi-tenant.

See examples

Troubleshooting

Diagnose and fix OAuth, SMTP, API, and routing issues quickly.

Fix issues

FAQ

Answers to the questions we get asked most often.

Read FAQ
  • Magic-Link — Passwordless authentication. Magic-Link uses Magic-Mail to send authentication emails automatically.
  • Magic-Sessionmanager — Session tracking. Can send security alerts via Magic-Mail.

Made by Joulee Tech GmbH. Free tier · 30-day money-back guarantee on paid tiers.