Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-17142316465.4 KB

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

You cannot use this operation 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.

get/#Action=SendBounce

Query parameters

OriginalMessageIdstring required

The message ID of the message to be bounced.

BounceSenderstring required

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

Explanationstring

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

ReportingMtastring required

The reporting MTA that attempted to deliver the message, formatted as specified in <a href="https://tools.ietf.org/html/rfc3464">RFC 3464</a> (<code>mta-name-type; mta-name</code>). The default value is <code>dns; inbound-smtp.[region].amazonaws.com</code>.

ArrivalDatestring date-time

When the message was received by the reporting mail transfer agent (MTA), in <a href="https://www.ietf.org/rfc/rfc0822.txt">RFC 822</a> date-time format.

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

Recipientstring required

The email address of the recipient of the bounced email.

RecipientArnstring

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 receive email for the recipient of the bounced email. For more information about sending authorization, see the <a href="https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html">Amazon SES Developer Guide</a>.

BounceType'DoesNotExist' | 'MessageTooLarge' | 'ExceededQuota' | 'ContentRejected' | 'Undefined' | 'TemporaryFailure'

The reason for the bounce. You must provide either this parameter or <code>RecipientDsnFields</code>.

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 <code>BouncedRecipientInfo</code> in the list.

BounceSenderArnstring

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 <a href="https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html">Amazon SES Developer Guide</a>.

Action'SendBounce' required
Version'2010-12-01' required

Response

Success