Amazon Simple Email Service
Developer Guide (API Version 2010-12-01)

What Is Amazon SES?

Welcome to the Amazon Simple Email Service (Amazon SES) Developer Guide. Amazon SES is an email platform that provides an easy, cost-effective way for you to send and receive email using your own email addresses and domains. For example, you can send marketing emails such as special offers, transactional emails such as order confirmations, and other types of correspondence such as newsletters. You only pay for what you use, so you can send and receive as much or as little email as you like. For service highlights, FAQs, and pricing information, go to the Amazon Simple Email Service Detail Page.

Why use Amazon SES?

Building a large-scale email solution is often a complex and costly challenge for a business. You must deal with infrastructure challenges such as email server management, network configuration, and IP address reputation. Additionally, many third-party email solutions require contract and price negotiations, as well as significant up-front costs. Amazon SES eliminates these challenges and enables you to benefit from the years of experience and sophisticated email infrastructure has built to serve its own large-scale customer base.

Amazon SES and other AWS services

Amazon SES integrates seamlessly with other AWS products. For example, you can:

  • Add email capabilities to any application that runs on an Amazon EC2 instance by using the AWS SDKs or the Amazon SES API. If you want to send email through Amazon SES from an Amazon EC2 instance, you can get started with Amazon SES for free.

  • Use Elastic Beanstalk to create an email-enabled application such as a program that uses Amazon SES to send a newsletter to customers.

  • Set up Amazon Simple Notification Service (Amazon SNS) to notify you of your emails that bounced, produced a complaint, or were successfully delivered to the recipient's mail server. When you use Amazon SES to receive emails, your email content can be published to Amazon SNS topics.

  • Use the AWS Management Console to set up Easy DKIM, which is a way to authenticate your emails. Although you can use Easy DKIM with any DNS provider, it is especially easy to set up when you manage your domain with Amazon Route 53.

  • Control user access to your email sending by using AWS Identity and Access Management (IAM).

  • Store emails you receive in Amazon Simple Storage Service (Amazon S3).

  • Take action on your received emails by triggering AWS Lambda functions.

  • Use AWS Key Management Service (AWS KMS) to optionally encrypt the mail you receive in your Amazon S3 bucket.

  • Use AWS CloudTrail (CloudTrail) to log Amazon SES API calls that you make using the console or the Amazon SES API.

In this guide

This guide contains the following sections:


Sending Email

Describes how you can send email using Amazon SES.

Receiving Email

Describes how you can receive email using Amazon SES.

Controlling Access

Shows you how to use Amazon SES with AWS Identity and Access Management (IAM) to specify which Amazon SES API actions a user can perform on which Amazon SES resources.

Logging API Calls

Provides a list of Amazon SES APIs that can be logged using AWS CloudTrail.

Using Credentials

Explains the types of credentials that you might use with Amazon SES, and when you might use them.

Using the API

Describes how to use the Amazon SES Query API.


Lists the Amazon SES SMTP and API endpoints for the AWS regions in which Amazon SES is available, and contains information you need to know when you use Amazon SES endpoints in multiple regions.


Provides a list of limits within Amazon SES.


Lists resources that you may find useful as you work with Amazon SES


Provides supplementary information about header fields, unsupported attachment types, and scripts.

For technical discussions about various Amazon SES topics, visit the Amazon SES blog. To browse and post questions, go to the Amazon SES forum.