Amazon Simple Email Service

Developer Guide

Amazon Simple Email Service

Copyright ? 2024 Amazon Web Services, Inc. and/or its a?liates. All rights reserved.

Amazon Simple Email Service

Developer Guide

Amazon Simple Email Service: Developer Guide

Copyright ? 2024 Amazon Web Services, Inc. and/or its a?liates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service

that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any

manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are

the property of their respective owners, who may or may not be a?liated with, connected to, or

sponsored by Amazon.

Amazon Simple Email Service

Developer Guide

Table of Contents

What is Amazon SES? ...................................................................................................................... 1

Bene?ts ........................................................................................................................................................... 1

Related services ............................................................................................................................................ 1

Pricing ............................................................................................................................................................. 2

Regions ............................................................................................................................................................ 2

SES regions and endpoints ...................................................................................................................

Sandbox removal and sending limit increases ..................................................................................

Veri?cation of email addresses and domains ...................................................................................

Easy DKIM .................................................................................................................................................

3

4

4

4

Account-level suppression list .............................................................................................................. 4

Feedback noti?cations ........................................................................................................................... 5

SMTP credentials ..................................................................................................................................... 5

Feedback endpoints used for custom MAIL FROM domains .......................................................... 5

Sending authorization ............................................................................................................................ 6

Email receiving ......................................................................................................................................... 6

Quotas ............................................................................................................................................................. 6

Email sending quotas ............................................................................................................................. 7

Email receiving quotas ......................................................................................................................... 11

Mail Manager quotas ........................................................................................................................... 12

General quotas ...................................................................................................................................... 13

Types of credentials ................................................................................................................................... 14

How Amazon SES works ........................................................................................................................... 18

After a sender sends an email request to SES ............................................................................... 19

After Amazon SES sends an email .................................................................................................... 20

Email format .......................................................................................................................................... 22

Understanding deliverability .............................................................................................................. 26

Email best practices ............................................................................................................................. 31

Working with AWS SDKs .......................................................................................................................... 37

Getting started .............................................................................................................................. 39

Setting up .................................................................................................................................................... 39

Sign up for AWS ................................................................................................................................... 39

Set up your SES account ..................................................................................................................... 40

Grant programmatic access (To interact with SES outside of the console) ............................... 40

Download an AWS SDK (For using the SES APIs) .......................................................................... 42

iii

Amazon Simple Email Service

Developer Guide

Migrating to Amazon SES ........................................................................................................................ 42

Step 1. Verify your domain ................................................................................................................ 42

Step 2. Request production access ................................................................................................... 42

Step 3. Con?gure domain authentication systems ........................................................................ 43

Step 4. Generate your SMTP credentials ......................................................................................... 43

Step 5. Connect to an SMTP endpoint ............................................................................................ 43

Next steps ............................................................................................................................................... 43

Request production access .......................................................................................................................

Sending limits ................................................................................................................................

Increasing your sending quotas ..............................................................................................................

Automatically increased sending quotas .........................................................................................

44

48

49

50

User requested increased sending quotas ....................................................................................... 50

Monitoring your sending quotas ............................................................................................................. 51

Monitoring your sending quotas using the Amazon SES console ............................................... 52

Monitoring your sending quotas using the Amazon SES API ...................................................... 53

Sending quota errors ................................................................................................................................. 53

Reaching sending limits with the Amazon SES API ....................................................................... 53

Reaching sending limits with SMTP .................................................................................................. 54

Set up email sending .................................................................................................................... 55

Using the SMTP interface ........................................................................................................................ 55

Requirements to send email over SMTP .......................................................................................... 56

Methods to send email over SMTP ................................................................................................... 56

Email information to provide ............................................................................................................. 57

Obtaining SMTP credentials ............................................................................................................... 57

Connecting to an SMTP endpoint ..................................................................................................... 63

Using software packages to send email .......................................................................................... 64

Sending emails programmatically ..................................................................................................... 66

Integrating with your existing email server .................................................................................... 76

Testing your connection to the Amazon SES SMTP interface ..................................................... 79

Using the API .............................................................................................................................................. 87

Sending formatted email .................................................................................................................... 89

Sending raw email ................................................................................................................................ 89

Using templates to send email ....................................................................................................... 101

Sending email using an AWS SDK .................................................................................................. 119

Content encodings ............................................................................................................................. 138

Supported security protocols ................................................................................................................ 139

iv

Amazon Simple Email Service

Developer Guide

Email sender to Amazon SES ........................................................................................................... 139

Amazon SES to receiver .................................................................................................................... 140

End-to-end encryption ...................................................................................................................... 140

Supported header ?elds ......................................................................................................................... 141

Unsupported attachment types ............................................................................................................ 144

Email receiving ............................................................................................................................ 146

Email receiving concepts & use cases ................................................................................................. 147

Recipient-based control using receipt rules ..................................................................................

IP-based control using IP address ?lters .......................................................................................

Email-receiving process .....................................................................................................................

Use cases & restrictions ....................................................................................................................

147

149

150

151

Email authentication and malware detection .............................................................................. 154

Setting up email receiving ..................................................................................................................... 155

Verifying your domain ....................................................................................................................... 156

Publishing an MX record ................................................................................................................... 156

Giving permission ............................................................................................................................... 159

Email receiving console walkthroughs ................................................................................................ 167

Creating receipt rules ........................................................................................................................ 167

Create IP ?lters ................................................................................................................................... 206

Email receiving metrics ........................................................................................................................... 208

Veri?ed identities ........................................................................................................................ 212

Creating & verifying identities .............................................................................................................. 212

Creating a domain identity .............................................................................................................. 215

Verifying a domain identity ............................................................................................................. 219

Creating an email address identity ................................................................................................. 223

Verifying an email address identity ................................................................................................ 224

Create & verify an identity and assign a default con?guration set at the same time (API) .. 225

Using custom veri?cation email templates ................................................................................... 226

Managing identities ................................................................................................................................. 238

View identities using the console ................................................................................................... 239

Delete an identity using the console ............................................................................................. 240

Edit an identity using the console .................................................................................................. 241

Edit an identity to use a default con?guration set using the SES API ..................................... 242

Retrieve the default con?guration set used by the identity using the SES API ..................... 243

Override the current default con?guration set used by the identity using the SES API ....... 243

Con?guring identities .............................................................................................................................. 244

v

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download