How do I troubleshoot 5xx errors from Amazon SNS?

2 minute read

I want to troubleshoot why I get an error message with an HTTP 5xx error status code when I run an Amazon Simple Notification Service (Amazon SNS) API action.


A 5xx error or status code indicates a server-side issue that must be resolved by AWS. To reduce the 5xx errors from Amazon SNS, implement retry logic in your application for requests that fail with a 5xx error. The most efficient retry count depends on your use case.

There are two types of 5xx errors that Amazon SNS returns:


The request processing failed because of an unknown error, exception, or failure.

HTTP Status Code: 500


The request failed because of a temporary server failure.

HTTP Status Code: 503

Troubleshoot 5xx errors

If you receive 5xx errors after you implement retries, then go to the AWS Service Health Dashboard. Check whether there are operational issues with Amazon SNS. If the AWS Service Health Dashboard doesn't show the errors that you received, then contact AWS Support.

When you contact AWS Support, make sure that you provide the following information:

  • The time when the issue started to occur.
  • Three to five AWS Request IDs for the API requests that are generating 5XX errors, along with the timestamp and timezone.
  • Approximate percentage of requests failing from total requests.

Related information

Common errors (Amazon SNS API Reference)

AWS OFFICIALUpdated 6 months ago