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

Sending Formatted Email Using the Amazon SES API

You can send a formatted email by using the AWS Management Console or by calling the Amazon SES API through an application directly, or indirectly through an AWS SDK, the AWS Command Line Interface, or the AWS Tools for Windows PowerShell.

The Amazon SES API provides the SendEmail action, which lets you compose and send a formatted email. SendEmail requires a From: address, To: address, message subject, and message body—text, HTML, or both. For a complete description of SendEmail, go to the Amazon Simple Email Service API Reference.


When you use SendEmail, the email address string must be 7-bit ASCII. If you want it to contain any other characters, then you must use MIME encoded-word syntax (RFC 2047) instead of a literal string. To use MIME-encoded word syntax, you need to use SendRawEmail as described in Using MIME. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=. For more information, see RFC 2047.

For an example of how to compose a formatted message using the AWS SDK for Java or the AWS SDK for .NET, see Sending an Email Through Amazon SES Using AWS SDK for Java or Sending an Email Through Amazon SES Using AWS SDK for .NET, respectively.

For tips on how to increase your email sending speed when you make multiple calls to SendEmail, see Increasing Throughput with Amazon SES.