POST

/v1/email/outbound-emails

http://email.{region}.amazonaws.com/v1/email/outbound-emails

Sends an email message. You can use the Amazon Pinpoint Email API to send two types of messages: <ul> <li> 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. </li> <li> 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. </li> </ul>

Access Token Required: API Key

Body Params

Contentobjectrequired

An object that defines the entire content of the email, including the message headers and the body content. You can create a simple email message, in which you specify the subject and the text and HTML versions of the message body. You can also create raw messages, in which you specify a complete MIME-formatted message. Raw messages can include attachments and custom headers.

EmailTagsarray

A list of message tags.

Destinationobjectrequired

An object that describes the recipients for an email.

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.

ReplyToAddressesarray

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

ConfigurationSetNamestring

The name of a configuration set. In Amazon Pinpoint, configuration sets 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.

FeedbackForwardingEmailAddressstring

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

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://email.{region}.amazonaws.com/v1/email/outbound-emails' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}