SendGrid API Integration

SendGrid provides a robust API for email delivery with built-in analytics, template management, and deliverability optimization. It handles the complexities of email infrastructure so you can focus on your application.

Setting Up SendGrid

```javascript
const sgMail = require('@sendgrid/mail');

sgMail.setApiKey(process.env.SENDGRID_API_KEY);

// Configure sender identity
const senderConfig = {
email: 'noreply@myapp.com',
name: 'MyApp'
};

// Send a simple email
async function sendPasswordReset(email, resetToken) {
const msg = {
to: email,
from: senderConfig,
templateId: 'd-abc123def456',
dynamicTemplateData: {
resetLink: `https://myapp.com/reset?token=\${resetToken}\`,
expirationTime: '24 hours'
}
};

try {
const response = await sgMail.send(msg);
console.log('Email sent successfully');
return response;
} catch (error) {
console.error('SendGrid error:', error.response.body.errors);
throw error;
}
}
```

SendGrid with Handlebars Templates

```javascript
// SendGrid supports dynamic templates with handlebars syntax
const orderConfirmation = {
to: customerEmail,
from: senderConfig,
templateId: 'd-order-confirmation',
dynamicTemplateData: {
customerName: 'John Doe',
orderNumber: 'ORD-2024-001',
orderDate: new Date().toLocaleDateString(),
items: [
{ name: 'Product A', quantity: 2, price: 29.99 },
{ name: 'Product B', quantity: 1, price: 49.99 }
],
subtotal: 109.97,
shipping: 9.99,
total: 119.96
}
};

await sgMail.send(orderConfirmation);
```

Batch Sending and Rate Limiting

```javascript
const pLimit = require('p-limit');

// SendGrid allows 100 messages per API call
const BATCH_SIZE = 100;
const concurrencyLimit = pLimit(5); // 5 concurrent API calls

async function sendBatchEmails(recipients, templateId, templateData) {
const batches = [];

for (let i = 0; i < recipients.length; i += BATCH_SIZE) {
batches.push(recipients.slice(i, i + BATCH_SIZE));
}

const results = await Promise.all(
batches.map((batch, index) =>
concurrencyLimit(async () => {
const messages = batch.map(recipient => ({
to: recipient.email,
from: senderConfig,
templateId,
dynamicTemplateData: {
...templateData,
recipientName: recipient.name
}
}));

    return sgMail.send(messages);
  })
)

);

return results.flat();
}
```

AWS SES for Scalable Email

Amazon Simple Email Service (SES) offers cost-effective email sending at scale. At $0.10 per 1,000 emails, it's ideal for high-volume applications. SES requires domain verification and proper authentication setup.

SES Configuration

```javascript
const { SESClient, SendEmailCommand } = require('@aws-sdk/client-ses');

const sesClient = new SESClient({
region: process.env.AWS_REGION || 'us-east-1',
credentials: {
accessKeyId: process.env.AWS_ACCESS_KEY_ID,
secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
}
});

// Send email with SES
async function sendSESEmail(to, subject, htmlBody) {
const command = new SendEmailCommand({
Source: 'noreply@myapp.com',
Destination: {
ToAddresses: Array.isArray(to) ? to : [to]
},
Message: {
Subject: {
Data: subject,
Charset: 'UTF-8'
},
Body: {
Html: {
Data: htmlBody,
Charset: 'UTF-8'
},
Text: {
Data: htmlBody.replace(/<[^>]*>/g, ''),
Charset: 'UTF-8'
}
}
},
ReplyToAddresses: ['support@myapp.com']
});

try {
const response = await sesClient.send(command);
console.log('Email sent via SES:', response.MessageId);
return response;
} catch (error) {
console.error('SES error:', error.name, error.message);
throw error;
}
}
```

Domain Verification and DNS Setup

To send emails from your domain via SES, you must verify it:

```

SPF Record (TXT)

myapp.com. IN TXT "v=spf1 include:amazonses.com ~all"

DKIM Record (CNAME) - provided by SES

sesdomainkey.myapp.com. IN CNAME abc123.dkim.amazonses.com

DMARC Record (TXT)

_dmarc.myapp.com. IN TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@myapp.com"
```

SES Templates with HTML

```javascript
const {
CreateTemplateCommand,
SendTemplatedEmailCommand
} = require('@aws-sdk/client-ses');

// Create a reusable template
async function createEmailTemplate() {
const template = {
TemplateName: 'WelcomeTemplate',
Subject: 'Welcome to {{appName}}, {{userName}}!',
HtmlPart: `

<body style="font-family: sans-serif;">

Hello {{userName}},

Welcome to {{appName}}! Your account is ready.

<a href="{{dashboardUrl}}" style="
display: inline-block;
padding: 10px 20px;
background: #007bff;
color: white;
text-decoration: none;
border-radius: 5px;
">Go to Dashboard


`,
TextPart: 'Hello {{userName}}, Welcome to {{appName}}!'
};

const command = new CreateTemplateCommand(template);
return sesClient.send(command);
}

// Send using template
async function sendTemplatedEmail(to, templateData) {
const command = new SendTemplatedEmailCommand({
Source: 'noreply@myapp.com',
Destination: { ToAddresses: [to] },
Template: 'WelcomeTemplate',
TemplateData: JSON.stringify(templateData)
});

return sesClient.send(command);
}
```

Email Template Design

Effective email templates must work across dozens of email clients. Use inline CSS, table-based layouts, and MJML for reliable rendering.

Responsive HTML Template Structure

```html

\`\`\`

MJML for Responsive Emails

```javascript
const mjml = require('mjml');

function generateEmailTemplate(data) {
const mjmlTemplate = `



<mj-all font-family="Arial, sans-serif" />
<mj-text font-size="16px" color="#333" />



<mj-section background-color="#007bff">

<mj-text align="center" color="white" font-size="24px">
Welcome, ${data.name}!





${data.message}
<mj-button href="${data.actionUrl}" background-color="#007bff">
${data.actionText}





<mj-text font-size="12px" color="#999">
© 2024 MyApp. All rights reserved.





`;

const { html } = mjml(mjmlTemplate, { minify: true });
return html;
}
```

Email Delivery Checklist

• Authentication: Set up SPF, DKIM, and DMARC records
• Testing: Send test emails to Gmail, Outlook, Yahoo, and Apple Mail
• Tracking: Add UTM parameters for campaign tracking
• Unsubscribe: Include one-click unsubscribe headers (RFC 8058)
• Bounce Handling: Process bounce and complaint notifications via webhooks
• Rate Limiting: Respect provider limits (SendGrid: 100/sec, SES: 14/sec in sandbox)