Menu
Amazon Simple Email Service
API Reference (API Version 2010-12-01)

SendBounce

Generates and sends a bounce message to the sender of an email you received through Amazon SES. You can only use this API on an email up to 24 hours after you receive it.

Note

You cannot use this API to send generic bounces for mail that was not received by Amazon SES.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

BouncedRecipientInfoList.member.N

A list of recipients of the bounced message, including the information required to create the Delivery Status Notifications (DSNs) for the recipients. You must specify at least one BouncedRecipientInfo in the list.

Type: Array of BouncedRecipientInfo objects

Required: Yes

BounceSender

The address to use in the "From" header of the bounce message. This must be an identity that you have verified with Amazon SES.

Type: String

Required: Yes

BounceSenderArn

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the address in the "From" header of the bounce. For more information about sending authorization, see the Amazon SES Developer Guide.

Type: String

Required: No

Explanation

Human-readable text for the bounce message to explain the failure. If not specified, the text will be auto-generated based on the bounced recipient information.

Type: String

Required: No

MessageDsn

Message-related DSN fields. If not specified, Amazon SES will choose the values.

Type: MessageDsn object

Required: No

OriginalMessageId

The message ID of the message to be bounced.

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

MessageId

The message ID of the bounce message.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

MessageRejected

Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: