The SendMessage action delivers a message to the specified queue. The maximum allowed message size is 8 KB.


The following list shows the characters (in Unicode) allowed in your message, according to the W3C XML specification (for more information, go to If you send any characters not included in the list, your request will be rejected.

#x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]

Request Parameters

The following table lists the special request parameters the SendMessage action uses in addition to the common request parameters all actions use (for more information, see Request Parameters Common to All Actions).



The message to send.

Type: String maximum 8 KB in size. For a list of allowed characters, see the preceding important note.


Response Elements

The following table lists the response elements the SendMessage action returns in addition to the common response elements all actions return (for more information, see Structure of a Successful Response).



An MD5 digest of the non-URL-encoded message body string. You can use this to verify that SQS received the message correctly. SQS first URL decodes the message before creating the MD5 digest. For information about MD5, go to

Type: String

Ancestor: SendMessageResult


An element containing the message ID of the message sent to the queue. For more information, see Queue and Message Identifiers.

Type: String

Ancestor: SendMessageResult

Special Errors

The following table lists the special errors the SendMessage action returns in addition to the common errors all actions return (for more information, see Errors Common to all Actions).

ErrorDescriptionHTTP Status Code


The message contains characters outside the allowed set.



The message size cannot exceed 8 KB.



Sample Request

The following example SendMessage request sends a message containing "Your Message Text" to the queue. You must URL encode the entire URL; however, we've URL encoded only the message body to make the example easier for you to read.

Sample Response

The following example response includes the MD5 digest for Your Message Text.


Related Actions