​

Migrating to Mailofly

​

Migration Framework at a Glance

​

Phase 1: Pre-Flight Audit

1. Inventory Senders & Domains: Identify every root domain and subdomain sending email, their current SPF, DKIM, and DMARC settings, and custom tracking domains.
2. Catalog Email Types:
   • Transactional: Password resets, OTPs, receipts, account notifications (high urgency, high open rate).
   • Broadcasts / Newsletters: Marketing campaigns, product updates, scheduled digests.
   • Inbound / Receiving: Inbound webhooks, support desk addresses, catch-all forwarders.
3. Audit Templates & Variables: List dynamic templates, merge tags, and conditional logic used in transactional emails.
4. Identify Integration Touchpoints:
   • Official SDKs (@sendgrid/mail, resend, postmark, boto3)
   • SMTP relays (WordPress, Laravel, Supabase, Nodemailer)
   • Webhook listeners (handling bounces, delivery confirmations, clicks)

​

Phase 2: Domain Verification & Sending Identities

​

Phase 3: Export Suppressions & Audiences

1. Export Suppressions from Old Provider:
   • Hard Bounces: Invalid addresses or rejected mailboxes.
   • Spam Complaints / Abuse Reports: Users who clicked “Report Spam”.
   • Unsubscribes: Contacts who opted out of promotional communications.
2. Import Suppressions into Mailofly:
   • Navigate to Audiences > Suppressions or use the Bulk Suppressions API.
3. Migrate Active Contacts:
   • Export verified active subscribers from your previous platform.
   • Import contacts into Mailofly using CSV import or the Audience API, mapping custom properties and subscription topics.

​

Phase 4: Dual-Sending & Gradual Cutover

// Example: Feature flag or percentage-based canary rollout
async function sendAppEmail(options: EmailOptions) {
  const shouldUseMailofly = Math.random() < 0.25; // 25% to Mailofly

  if (shouldUseMailofly) {
    return await mailoflyClient.emails.send(options);
  } else {
    return await legacyClient.send(options);
  }
}

# Legacy Provider
# SMTP_HOST=smtp.sendgrid.net
# SMTP_USER=apikey
# SMTP_PASS=SG.old_key...

# Mailofly SMTP Gateway
SMTP_HOST=smtp.mailofly.com
SMTP_PORT=587
SMTP_USER=mailofly
SMTP_PASS=mf_live_xxxxxxxxxxxxxxxxxxxxxxxx

​

Phase 5: Warm-up & Post-Migration Monitoring

• Keep Hard Bounces < 2%: Watch your bounce rates in real time on the Mail Logs dashboard.
• Keep Spam Complaints < 0.1%: Ensure one-click unsubscribe headers (List-Unsubscribe) are active on all marketing messages.
• Inspect Webhook Events: Verify that email.delivered, email.bounced, and email.opened events are correctly ingested by your backend.

​

Platform Comparison Matrix

​

Platform-Specific Migration Guides