v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1442212198.5 KB

Sends an email message. You can use the Amazon Pinpoint Email API to send two types of messages:

  • Simple – A standard email message. When you create this type of message, you specify the sender, the recipient, and the message body, and Amazon Pinpoint assembles the message for you.

  • Raw – A raw, MIME-formatted email message. When you send this type of email, you have to specify all of the message headers, as well as the message body. You can use this message type to send messages that contain attachments. The message that you specify has to be a valid MIME message.

post/v1/email/outbound-emails

Request body

FromEmailAddressstring

The email address that you want to use as the "From" address for the email. The address that you specify has to be verified.

ReplyToAddressesEmailAddress[]

The "Reply-to" email addresses for the message. When the recipient replies to the message, each Reply-to address receives the reply.

FeedbackForwardingEmailAddressstring

The address that Amazon Pinpoint should send bounce and complaint notifications to.

ConfigurationSetNamestring
<p>The name of a configuration set.</p> <p>In Amazon Pinpoint, <i>configuration sets</i> are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.</p>

Response

Success

MessageIdstring
<p>A unique identifier for the message that is generated when Amazon Pinpoint accepts the message.</p> <note> <p>It is possible for Amazon Pinpoint to accept a message without sending it. This can happen when the message you're trying to send has an attachment doesn't pass a virus check, or when you send a templated email that contains invalid personalization content, for example.</p> </note>