AWS Simple Email Service (SES) is a powerful, cost-effective solution that can help you send emails securely, whether it's for transactional messages, marketing campaigns, or automated notifications.
In this blog post, we'll explore how to use AWS SES to send emails, covering various use cases like sending HTML templates, attachments, and even calendar events. We'll walk through practical examples to help you get started quickly.
Table of Contents
- What is AWS SES?
- Setting Up AWS SES
- Sending a Simple Email
- Sending HTML Emails
- Sending Emails with Attachments
- Sending Calendar Invites
- Best Practices
- Conclusion
What is AWS SES?
AWS Simple Email Service (SES) is a cloud-based email sending service designed to help digital marketers and application developers send marketing, notification, and transactional emails. It is a reliable, scalable, and cost-effective service for businesses of all sizes.
Key Features:
- Scalability: Handles large volumes of emails effortlessly.
- Deliverability: High deliverability rates due to AWS's reputation.
- Cost-Effective: Pay-as-you-go pricing model.
- Security: Supports authentication mechanisms like DKIM and SPF.
Setting Up AWS SES
Before we dive into sending emails, let's set up AWS SES for your account.
Step 1: Verify Your Email Address or Domain
AWS SES requires you to verify the email addresses or domains you plan to use.
- Verify an Email Address:
- Go to the AWS SES console.
- Navigate to Email Addresses under Identity Management.
- Click Verify a New Email Address.
- Enter your email address and click Verify This Email Address.
- Check your inbox and click the verification link in the email from AWS.
- Verify a Domain:
- Navigate to Domains under Identity Management.
- Click Verify a New Domain.
- Enter your domain name.
- AWS will provide DNS records. Add these to your domain's DNS settings.
Step 2: Request Production Access
By default, new AWS accounts are in the Sandbox environment, which limits email sending capabilities.
- Go to the SES Sending Limits page.
- Click Request a Sending Limit Increase.
- Fill out the request form to move out of the sandbox.
Step 3: Set Up AWS Credentials
You'll need AWS access keys to interact with SES programmatically.
- Go to the AWS IAM console.
- Create a new user with Programmatic access.
- Attach the AmazonSESFullAccess policy.
- Save your Access Key ID and Secret Access Key.
Sending a Simple Email
Let's start by sending a simple plain-text email using AWS SDK for Node.js.
Prerequisites
- Node.js installed on your machine.
- AWS SDK for Node.js (aws-sdk) installed.
Code Example
const AWS = require('aws-sdk');
// Configure AWS SDK
AWS.config.update({
accessKeyId: 'YOUR_ACCESS_KEY_ID',
secretAccessKey: 'YOUR_SECRET_ACCESS_KEY',
region: 'us-east-1', // Replace with your SES region
});
const ses = new AWS.SES();
const params = {
Source: 'sender@example.com',
Destination: {
ToAddresses: ['recipient@example.com'],
},
Message: {
Subject: {
Data: 'Test Email from AWS SES',
},
Body: {
Text: {
Data: 'Hello, this is a test email sent using AWS SES!',
},
},
},
};
ses.sendEmail(params, (err, data) => {
if (err) {
console.error('Error sending email', err);
} else {
console.log('Email sent successfully', data);
}
});
Explanation:
- Source: The verified email address you're sending from.
- Destination: The recipient's email address.
- Message: Contains the subject and body of the email.
Sending HTML Emails
Now, let's send an email with HTML content to make it more visually appealing.
Code Example
const params = {
Source: 'sender@example.com',
Destination: {
ToAddresses: ['recipient@example.com'],
},
Message: {
Subject: {
Data: 'Welcome to Our Service!',
},
Body: {
Html: {
Data: `
<html>
<body>
<h1>Welcome!</h1>
<p>We're glad to have you on board.</p>
</body>
</html>
`,
},
},
},
};
ses.sendEmail(params, (err, data) => {
if (err) {
console.error('Error sending HTML email', err);
} else {
console.log('HTML email sent successfully', data);
}
});
Tips:
- You can include CSS styles inline or use basic styling to ensure compatibility across email clients.
- Always include a plain-text version as a fallback.
Sending Emails with Attachments
To send emails with attachments, we'll use the sendRawEmail method instead of sendEmail.
Code Example
const fs = require('fs');
const path = require('path');
const AWS = require('aws-sdk');
const ses = new AWS.SES();
// Read the attachment file
const filePath = path.join(__dirname, 'attachment.pdf');
const fileContent = fs.readFileSync(filePath);
// Define the email parameters
const params = {
RawMessage: {
Data: createRawEmail(),
},
};
function createRawEmail() {
const boundary = '----=_Part_0_123456789.123456789';
let rawEmail = [
`From: sender@example.com`,
`To: recipient@example.com`,
`Subject: Email with Attachment`,
`MIME-Version: 1.0`,
`Content-Type: multipart/mixed; boundary="${boundary}"`,
``,
`--${boundary}`,
`Content-Type: text/plain; charset=UTF-8`,
`Content-Transfer-Encoding: 7bit`,
``,
`Hello, please find the attached document.`,
`--${boundary}`,
`Content-Type: application/pdf; name="attachment.pdf"`,
`Content-Description: attachment.pdf`,
`Content-Disposition: attachment; filename="attachment.pdf";`,
`Content-Transfer-Encoding: base64`,
``,
fileContent.toString('base64'),
`--${boundary}--`,
].join('\n');
return rawEmail;
}
ses.sendRawEmail(params, (err, data) => {
if (err) {
console.error('Error sending email with attachment', err);
} else {
console.log('Email with attachment sent successfully', data);
}
});
Explanation:
- Multipart MIME Message: We construct a raw email with MIME boundaries to include attachments.
- Base64 Encoding: Attachments must be base64 encoded.
- Content Headers: Proper headers are necessary for the email client to interpret the attachment correctly.
Sending Calendar Invites
To send a calendar event, we'll include an .ics file as an attachment.
Code Example
function createCalendarEvent() {
const event = [
'BEGIN:VCALENDAR',
'VERSION:2.0',
'BEGIN:VEVENT',
'DTSTAMP:20231016T090000Z',
'DTSTART:20231020T100000Z',
'DTEND:20231020T110000Z',
'SUMMARY:Meeting Invitation',
'DESCRIPTION:Discuss project updates',
'LOCATION:Conference Room',
'END:VEVENT',
'END:VCALENDAR',
].join('\n');
return Buffer.from(event).toString('base64');
}
function createRawEmail() {
const boundary = '----=_Part_0_123456789.123456789';
let rawEmail = [
`From: sender@example.com`,
`To: recipient@example.com`,
`Subject: Meeting Invitation`,
`MIME-Version: 1.0`,
`Content-Type: multipart/mixed; boundary="${boundary}"`,
``,
`--${boundary}`,
`Content-Type: text/plain; charset=UTF-8`,
`Content-Transfer-Encoding: 7bit`,
``,
`Hello, you're invited to a meeting.`,
`--${boundary}`,
`Content-Type: text/calendar; method=REQUEST; name="invite.ics"`,
`Content-Transfer-Encoding: base64`,
`Content-Disposition: attachment; filename="invite.ics"`,
``,
createCalendarEvent(),
`--${boundary}--`,
].join('\n');
return rawEmail;
}
ses.sendRawEmail(params, (err, data) => {
if (err) {
console.error('Error sending calendar invite', err);
} else {
console.log('Calendar invite sent successfully', data);
}
});
Explanation:
- Calendar Event Format: We create an .ics file content using the iCalendar format.
- Method=REQUEST: Indicates that this is a meeting invitation.
- Proper Headers: Ensuring correct Content-Type and Content-Disposition for calendar files.
Best Practices
- Error Handling: Always include robust error handling in your applications.
- Email Validation: Ensure that email addresses are valid before sending.
- Throttling: Be aware of your SES sending limits to avoid throttling.
- Unsubscribe Links: Include unsubscribe options in marketing emails to comply with regulations.
- Monitoring: Use AWS CloudWatch to monitor your email sending activities.
- Security: Protect your AWS credentials and use IAM roles where possible.
Conclusion
AWS SES is a versatile service that can handle a variety of email sending needs. Whether you're sending simple notifications, marketing emails with rich HTML content, or complex messages with attachments and calendar events, AWS SES has you covered.
By following this guide, you should now have a solid understanding of how to:
- Set up AWS SES for your account.
- Send plain-text and HTML emails.
- Include attachments and calendar invites in your emails.
Thank you for reading! If you have any questions or tips to share, feel free to leave a comment below. Happy coding!
The above is the detailed content of Sending Emails with AWS SES: A Comprehensive Guide. For more information, please follow other related articles on the PHP Chinese website!
Hot AI Tools
Undress AI Tool
Undress images for free
Undresser.AI Undress
AI-powered app for creating realistic nude photos
AI Clothes Remover
Online AI tool for removing clothes from photos.
Clothoff.io
AI clothes remover
Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!
Hot Article
Hot Tools
Notepad++7.3.1
Easy-to-use and free code editor
SublimeText3 Chinese version
Chinese version, very easy to use
Zend Studio 13.0.1
Powerful PHP integrated development environment
Dreamweaver CS6
Visual web development tools
SublimeText3 Mac version
God-level code editing software (SublimeText3)
Hot Topics
How does garbage collection work in JavaScript?
Jul 04, 2025 am 12:42 AM
JavaScript's garbage collection mechanism automatically manages memory through a tag-clearing algorithm to reduce the risk of memory leakage. The engine traverses and marks the active object from the root object, and unmarked is treated as garbage and cleared. For example, when the object is no longer referenced (such as setting the variable to null), it will be released in the next round of recycling. Common causes of memory leaks include: ① Uncleared timers or event listeners; ② References to external variables in closures; ③ Global variables continue to hold a large amount of data. The V8 engine optimizes recycling efficiency through strategies such as generational recycling, incremental marking, parallel/concurrent recycling, and reduces the main thread blocking time. During development, unnecessary global references should be avoided and object associations should be promptly decorated to improve performance and stability.
How to make an HTTP request in Node.js?
Jul 13, 2025 am 02:18 AM
There are three common ways to initiate HTTP requests in Node.js: use built-in modules, axios, and node-fetch. 1. Use the built-in http/https module without dependencies, which is suitable for basic scenarios, but requires manual processing of data stitching and error monitoring, such as using https.get() to obtain data or send POST requests through .write(); 2.axios is a third-party library based on Promise. It has concise syntax and powerful functions, supports async/await, automatic JSON conversion, interceptor, etc. It is recommended to simplify asynchronous request operations; 3.node-fetch provides a style similar to browser fetch, based on Promise and simple syntax
JavaScript Data Types: Primitive vs Reference
Jul 13, 2025 am 02:43 AM
JavaScript data types are divided into primitive types and reference types. Primitive types include string, number, boolean, null, undefined, and symbol. The values are immutable and copies are copied when assigning values, so they do not affect each other; reference types such as objects, arrays and functions store memory addresses, and variables pointing to the same object will affect each other. Typeof and instanceof can be used to determine types, but pay attention to the historical issues of typeofnull. Understanding these two types of differences can help write more stable and reliable code.
JavaScript time object, someone builds an eactexe, faster website on Google Chrome, etc.
Jul 08, 2025 pm 02:27 PM
Hello, JavaScript developers! Welcome to this week's JavaScript news! This week we will focus on: Oracle's trademark dispute with Deno, new JavaScript time objects are supported by browsers, Google Chrome updates, and some powerful developer tools. Let's get started! Oracle's trademark dispute with Deno Oracle's attempt to register a "JavaScript" trademark has caused controversy. Ryan Dahl, the creator of Node.js and Deno, has filed a petition to cancel the trademark, and he believes that JavaScript is an open standard and should not be used by Oracle
React vs Angular vs Vue: which js framework is best?
Jul 05, 2025 am 02:24 AM
Which JavaScript framework is the best choice? The answer is to choose the most suitable one according to your needs. 1.React is flexible and free, suitable for medium and large projects that require high customization and team architecture capabilities; 2. Angular provides complete solutions, suitable for enterprise-level applications and long-term maintenance; 3. Vue is easy to use, suitable for small and medium-sized projects or rapid development. In addition, whether there is an existing technology stack, team size, project life cycle and whether SSR is needed are also important factors in choosing a framework. In short, there is no absolutely the best framework, the best choice is the one that suits your needs.
Understanding Immediately Invoked Function Expressions (IIFE) in JavaScript
Jul 04, 2025 am 02:42 AM
IIFE (ImmediatelyInvokedFunctionExpression) is a function expression executed immediately after definition, used to isolate variables and avoid contaminating global scope. It is called by wrapping the function in parentheses to make it an expression and a pair of brackets immediately followed by it, such as (function(){/code/})();. Its core uses include: 1. Avoid variable conflicts and prevent duplication of naming between multiple scripts; 2. Create a private scope to make the internal variables invisible; 3. Modular code to facilitate initialization without exposing too many variables. Common writing methods include versions passed with parameters and versions of ES6 arrow function, but note that expressions and ties must be used.
What is the cache API and how is it used with Service Workers?
Jul 08, 2025 am 02:43 AM
CacheAPI is a tool provided by the browser to cache network requests, which is often used in conjunction with ServiceWorker to improve website performance and offline experience. 1. It allows developers to manually store resources such as scripts, style sheets, pictures, etc.; 2. It can match cache responses according to requests; 3. It supports deleting specific caches or clearing the entire cache; 4. It can implement cache priority or network priority strategies through ServiceWorker listening to fetch events; 5. It is often used for offline support, speed up repeated access speed, preloading key resources and background update content; 6. When using it, you need to pay attention to cache version control, storage restrictions and the difference from HTTP caching mechanism.
Handling Promises: Chaining, Error Handling, and Promise Combinators in JavaScript
Jul 08, 2025 am 02:40 AM
Promise is the core mechanism for handling asynchronous operations in JavaScript. Understanding chain calls, error handling and combiners is the key to mastering their applications. 1. The chain call returns a new Promise through .then() to realize asynchronous process concatenation. Each .then() receives the previous result and can return a value or a Promise; 2. Error handling should use .catch() to catch exceptions to avoid silent failures, and can return the default value in catch to continue the process; 3. Combinators such as Promise.all() (successfully successful only after all success), Promise.race() (the first completion is returned) and Promise.allSettled() (waiting for all completions)
