Amazon Simple Email Service

Developer Guide

Amazon Simple Email Service

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

Amazon Simple Email Service

Amazon Simple Email Service: Developer Guide

Developer Guide

Copyright ? 2024 Amazon Web Services, Inc. and/or its affiliates. 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 affiliated with, connected to, or sponsored by Amazon.

Amazon Simple Email Service

Table of Contents

Developer Guide

What is Amazon SES? ...................................................................................................................... 1 Benefits ........................................................................................................................................................... 1 Related services ............................................................................................................................................ 1 Pricing ............................................................................................................................................................. 2 Regions ............................................................................................................................................................ 2 SES regions and endpoints ................................................................................................................... 3 Sandbox removal and sending limit increases .................................................................................. 4 Verification of email addresses and domains ................................................................................... 4 Easy DKIM ................................................................................................................................................. 4 Account-level suppression list .............................................................................................................. 4 Feedback notifications ........................................................................................................................... 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. Configure 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 ....................................................................................................................... 44 Sending limits ................................................................................................................................ 48

Increasing your sending quotas .............................................................................................................. 49 Automatically increased sending quotas ......................................................................................... 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 fields ......................................................................................................................... 141 Unsupported attachment types ............................................................................................................ 144 Email receiving ............................................................................................................................ 146 Email receiving concepts & use cases ................................................................................................. 147 Recipient-based control using receipt rules .................................................................................. 147 IP-based control using IP address filters ....................................................................................... 149 Email-receiving process ..................................................................................................................... 150 Use cases & restrictions .................................................................................................................... 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 ................................................................................................ 164 Creating receipt rules ........................................................................................................................ 165 Create IP filters ................................................................................................................................... 203 Email receiving metrics ........................................................................................................................... 204 Verified identities ........................................................................................................................ 208 Creating & verifying identities .............................................................................................................. 208 Creating a domain identity .............................................................................................................. 211 Verifying a domain identity ............................................................................................................. 215 Creating an email address identity ................................................................................................. 219 Verifying an email address identity ................................................................................................ 220 Create & verify an identity and assign a default configuration set at the same time (API) .. 221 Using custom verification email templates ................................................................................... 222 Managing identities ................................................................................................................................. 234 View identities using the console ................................................................................................... 235 Delete an identity using the console ............................................................................................. 236 Edit an identity using the console .................................................................................................. 237 Edit an identity to use a default configuration set using the SES API ..................................... 238 Retrieve the default configuration set used by the identity using the SES API ..................... 239 Override the current default configuration set used by the identity using the SES API ....... 239 Configuring identities .............................................................................................................................. 240

v

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

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

Google Online Preview   Download