|« PreviousNext »|
|Did this page help you? Yes | No | Tell us about it...|
This topic reviews the types of email sending-specific errors that you may encounter when you send an email through Amazon SES. If you try to send an email through Amazon SES and the call to Amazon SES fails, Amazon SES returns an error message to your application and does not send the email. The way that you observe this error message depends on the way that you call Amazon SES.
If you call the Amazon SES API directly, the Query action will return an error. The error may be
or one of the errors specified in the Common Errors
topic of the Amazon SES API Reference.
If you call Amazon SES using an AWS SDK that uses a programming language that supports exceptions, Amazon SES may throw an exception.
The type of exception depends on the SDK and on the error. For example,
the exception could be an Amazon SES
MessageRejectedException (the actual name may vary depending on the SDK) or a general AWS exception.
Regardless of the type of exception, the error type and the error message in the exception will give you more information.
If you call Amazon SES through its SMTP interface, the way that you experience the error depends on the application. Some applications may display a specific error message, some may not. For a list of SMTP response codes, see SMTP Response Codes Returned by Amazon SES.
When your call to Amazon SES to send an email fails, you are not billed for that email.
The following are the types of Amazon SES-specific problems that can cause Amazon SES to return an error when you try to send an email.
These errors are in addition to general AWS errors
MalformedQueryString as specified in the Common Errors
topic of the Amazon SES API Reference.
Email address is not verified—Your account is in the sandbox and one of the recipient email addresses has not been verified. This might apply to "Sender", "Return-Path", or "From" addresses.
If you have not requested production access to Amazon SES, you must verify every recipient email address except for the recipients provided by the Amazon SES mailbox simulator. You must also verify your own "From" address. For more information, see Verifying Email Addresses and Domains in Amazon SES and Testing Amazon SES Email Sending.
Customer is suspended—Your AWS account has been blocked from sending email using Amazon SES. You can still access the Amazon SES console and perform any activity (e.g., view your metrics) except for email sending; if you attempt to send an email, you will receive this error message.
If this happens, you should have received an email from Amazon SES to the email address associated with your AWS account informing you of the problem. To appeal your suspension and reinstate email sending privileges, follow the instructions in the email. You will need to explain in detail why you believe that the suspension itself was an error, or the changes you have made to ensure that the same problem does not occur again.
Throttling—Amazon SES is limiting the rate at which you can send messages. Your application may be trying to send too much email, or to send email at too fast a rate. In these cases, the error may be similar to the following:
Daily message quota exceeded—You have sent the maximum number of messages that you are permitted in a 24-hour period. If you have exceeded your daily quota, you will have to wait until the next 24-hour period before you can send more email.
Maximum sending rate exceeded—You are attempting to send more emails per second than is permitted by your maximum send rate. If you have exceeded your sending rate, you can continue to send email, but will need to reduce your send rate. For more information, see How to handle a "Throttling - Maximum sending rate exceeded" error on the Amazon SES blog.
You should regularly monitor your sending activity to see how close you are to your sending limits. For more information, see Monitoring Your Amazon SES Sending Limits. For general information about sending limits, see Managing Your Amazon SES Sending Limits. For information about how to increase your sending limits, see Increasing Your Amazon SES Sending Limits.
If the error text that explains the throttling error is not related to you exceeding your daily quota or maximum send rate, then there might be a system-wide problem that is causing reduced sending capabilities. For information about the service status, go to the AWS Service Health Dashboard at http://status.aws.amazon.com.