Transactional Email (SendGrid)
Send reliable transactional email with SendGrid: dynamic templates, event webhooks, unsubscribe management, and email deliverability best practices.
Transactional email (receipts, password resets, notifications) requires high deliverability and reliability. SendGrid handles SMTP infrastructure, reputation management, and analytics so you focus on content rather than email infrastructure.
Use dynamic templates for all user-facing emails - separates design from code. Implement unsubscribe management from day one (legal requirement in most jurisdictions). Monitor delivery rates. Use dedicated IP for high volumes (>50K/day).
Workflow
- Send with the SendGrid Node.js SDKThe SDK handles authentication, retry logic, and request formatting.
- Create dynamic templates in SendGridDynamic templates let designers edit email layouts without code changes.
- Set up event webhooks for trackingEvent webhooks tell you when emails are delivered, opened, clicked, bounced, or marked as spam.
- Implement unsubscribe managementUnsubscribe management is legally required (CAN-SPAM, GDPR) and reduces spam complaints.
- Optimize email deliverabilityEmails in spam folders are invisible - deliverability is the foundation of effective email.
Output Format
Dynamic templates for all email types, SDK sends with template IDs, event webhook storing delivery events, unsubscribe groups configured, SPF/DKIM/DMARC set up.
Examples
Send with template: `await sgMail.send({ to: user.email, from: "noreply@myapp.com", templateId: RECEIPT_TEMPLATE_ID, dynamicTemplateData: { userName: user.name, items: order.items, total: formatMoney(order.total), orderId: order.id } })`Batch send: `await sgMail.sendMultiple({ to: [email1, email2], from: "news@myapp.com", templateId: NEWSLETTER_ID, dynamicTemplateData: { unsubscribeLink } })`Check suppression: `const [res] = await sgClient.request({ url: `/v3/asm/suppressions/global/${email}`, method: "GET" }); const suppressed = res.statusCode === 200`Edge Cases & Gotchas
- Sandbox mode: test sends with `mailSettings: { sandboxMode: { enable: true } }` - email is processed but not delivered; useful for CI
- Rate limiting: SendGrid free tier has 100 emails/day limit; for production, use paid tiers; implement queueing to avoid burst rate limits
- Reply-To: for notifications, set `replyTo: "support@yourco.com"` so replies go to your support inbox, not the sending address
When to Break These Rules
- For internal team notifications (no user-facing emails), use simpler solutions like Slack webhooks or AWS SES directly - SendGrid's template management is overkill.
Reference Files
SendGrid Node.js SDK: https://github.com/sendgrid/sendgrid-nodejsSendGrid Dynamic Templates: https://docs.sendgrid.com/ui/sending-email/how-to-send-an-email-with-dynamic-templatesEmail deliverability: https://sendgrid.com/resource/email-deliverability-guide/