# Email Content Templates & Examples Quick reference for crafting emails using the BUILDMATE email endpoints. ## General Updates Examples ### New Feature Announcement ```json { "title": "πŸš€ New Feature: Advanced Build Comparison", "content": "We're thrilled to introduce our new side-by-side build comparison tool! Compare specs, performance, and prices of multiple builds instantly. This powerful feature makes it easier than ever to find the perfect configuration for your needs.", "actionUrl": "https://buildmate.com/dashboard", "actionText": "Start Comparing Builds" } ``` ### Security Update ```json { "title": "πŸ”’ Security Update Available", "content": "We've patched an important security vulnerability. All accounts have been updated automatically. No action is required from you, but we recommend changing your password if you use the same password on other platforms.", "actionUrl": "https://buildmate.com/settings", "actionText": "Update Your Password" } ``` ### Community Milestone ```json { "title": "🎊 BUILDMATE Hits 50,000 Builders!", "content": "We're amazing! Our community has grown to 50,000 PC builders sharing their creations and helping each other. Thank you for being part of this journey. To celebrate, we're running a special contest with prizes this month.", "actionUrl": "https://buildmate.com/community/contest", "actionText": "Enter the Contest" } ``` ### New Component in Database ```json { "title": "πŸ“¦ New Components Added: NVIDIA RTX 50 Series", "content": "The latest NVIDIA RTX 50 series GPUs are now available in our database! These next-gen cards bring incredible performance for gaming and content creation. Check out build recommendations optimized for these new cards.", "actionUrl": "https://buildmate.com/components?category=gpu&brand=nvidia", "actionText": "Explore New GPUs" } ``` ### Major Price Drop Alert ```json { "title": "πŸ’° Major Price Drops on Premium Components", "content": "Popular CPUs, GPUs, and RAM are on sale this week! We're seeing some of the best deals of the season. Log in to see price-optimized build suggestions for your saved builds.", "actionUrl": "https://buildmate.com/dashboard", "actionText": "Check Your Builds" } ``` ## Newsletter Examples ### Budget Gaming Focus ```json { "title": "March 2026 Newsletter - Budget Gaming Excellence", "content": "This month, we're highlighting incredible 1440p gaming builds under $1,200. GPU market shifts have created amazing value, and we've curated the best options. Discover high-refresh gaming without breaking the bank.", "featuredBuilds": [ { "id": 101, "name": "1440p Ultra Gaming - $1,150", "description": "Ultra settings at 100+ fps with RTX 4070 and i7-14700K. Perfect for competitive and single-player games.", "createdBy": "ProBuilder_Gaming", "createdAt": "2026-02-28" }, { "id": 102, "name": "1440p High Refresh - $1,100", "description": "120+ fps with RTX 4070 and balanced CPU. Optimized for esports and modern AAA titles.", "createdBy": "FPS_Master", "createdAt": "2026-02-27" }, { "id": 103, "name": "4K Console Killer - $1,200", "description": "Native 4K gaming at 60+ fps with top-tier components. Premium experience without premium price.", "createdBy": "UltraBuilder", "createdAt": "2026-02-26" } ] } ``` ### Content Creator Focus ```json { "title": "February Newsletter - Streaming & Content Creation", "content": "Whether you're streaming on Twitch, creating YouTube videos, or producing 4K content, we've compiled the best PC builds for content creators. From budget streaming rigs to professional production machines, find the perfect setup.", "featuredBuilds": [ { "id": 201, "name": "Entry-Level Streaming - $700", "description": "Perfect for beginners: 1080p60 streaming with Ryzen 5 and RTX 4050. Multi-monitor ready.", "createdBy": "StreamNewbie", "createdAt": "2026-02-25" }, { "id": 202, "name": "Pro Streaming Rig - $2,500", "description": "1440p streaming + gaming with dedicated streaming PC specs. Encoder heaven with RTX 4090.", "createdBy": "StreamPro_Elite", "createdAt": "2026-02-24" } ] } ``` ### Component Deep Dive ```json { "title": "January Newsletter - 2025 CPU Buyer's Guide", "content": "New year, new processors! Intel's 14th gen and AMD's Ryzen 9000 series are reshaping the market. We break down which CPUs offer the best value for gaming, productivity, and everything in between. Learn about cores, cache, power efficiency, and real-world performance.", "featuredBuilds": [ { "id": 301, "name": "Intel 14th Gen Powerhouse - $1,800", "description": "i9-14900KS with all cores maxed out. Benchmarking and heavy compute champion.", "createdBy": "TechReviewer", "createdAt": "2026-01-31" }, { "id": 302, "name": "AMD Ryzen Value King - $1,200", "description": "Ryzen 9 7950X3D with incredible price-to-performance. Gaming and streaming beast.", "createdBy": "ValueHunter", "createdAt": "2026-01-30" } ] } ``` ### Seasonal Guide ```json { "title": "Holiday Newsletter - Gift Guide for Tech Enthusiasts", "content": "The holidays are here! Whether you're building a PC for someone special or upgrading your own rig, we've got recommendations for every budget. CPU, GPU, peripheralsβ€”find the perfect gifts for the PC enthusiast in your life.", "featuredBuilds": [ { "id": 401, "name": "Gift: Gaming Girlfriend Rig - $1,500", "description": "Stylish, powerful, and perfect. RGB gaming with performance that matches prettier builds.", "createdBy": "CoolTech_Gifts", "createdAt": "2026-12-01" }, { "id": 402, "name": "Gift: Dad's Productivity PC - $800", "description": "Smooth office work, media editing, and entertainment. The perfect multi-task machine.", "createdBy": "FamilyBuilder", "createdAt": "2026-11-30" } ] } ``` ## Tips for Writing Great Content ### For General Updates: - **Keep it concise**: 2-3 sentences max before the call-to-action - **Use emojis wisely**: 1-2 relevant emojis in the title - **Be urgent when needed**: "New feature available now" vs. "Soon available" - **Always provide a link**: Every update should have actionUrl ### For Newsletters: - **Tell a story**: Connect the featured builds with a theme - **Add value**: Explain WHY these builds matter - **Show variety**: Include different budgets and use cases - **Highlight details**: Mention key specs (budget, fps, use case) ## Subject Line Best Practices ``` Good: βœ… "πŸŽ‰ New Feature: Build Comparison Tool" βœ… "GPU Deals You Don't Want to Miss" βœ… "BUILDMATE Newsletter - Budget Gaming Builds" Avoid: ❌ "UPDATE" (too generic) ❌ "Click here now!!!" (spammy) ❌ "URGENT: You need this" (misleading) ``` ## Sample Request Templates ### Testing with cURL: ```bash # Send a general update curl -X POST http://localhost:3000/api/emails/send-general-update \ -H "Content-Type: application/json" \ -d '{ "title": "πŸš€ New Feature Alert", "content": "Check out our brand new comparison tool that makes choosing components even easier!", "actionUrl": "https://buildmate.com/compare", "actionText": "Try It Now" }' # Send a newsletter curl -X POST http://localhost:3000/api/emails/send-newsletter \ -H "Content-Type: application/json" \ -d '{ "title": "Latest Newsletter", "content": "Discover the best budget builds this month.", "featuredBuilds": [] }' ``` ### Testing with JavaScript: ```javascript async function sendGeneralUpdate() { const response = await fetch('/api/emails/send-general-update', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ title: '🎊 New Community Feature', content: 'Share and discover builds with friends using our new social features!', actionUrl: 'https://buildmate.com/discover', actionText: 'Explore Community' }) }); const result = await response.json(); console.log(`Sent to ${result.sent} users`); } ``` ## Monitoring & Analytics After sending emails, track these metrics: - **Delivery Rate**: Successfully sent / Total attempted - **Open Rate**: Opened emails / Sent emails - **Click Rate**: Clicked link / Opened emails - **Bounce Rate**: Failed deliveries / Total sent Use these metrics to improve: - Subject lines (affects open rate) - Call-to-action text (affects click rate) - Email frequency (affects engagement) - Content type (what builds/topics resonate)