Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14109583546.7 KB

Creates a new multimedia message (MMS) and sends it to a recipient's phone number.

post/#X-Amz-Target=PinpointSMSVoiceV2.SendMediaMessage

Headers

X-Amz-Target'PinpointSMSVoiceV2.SendMediaMessage' required

Request body

DestinationPhoneNumberstring required

The destination phone number in E.164 format.

OriginationIdentitystring required
<p>The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, SenderId, SenderIdArn, PoolId, or PoolArn.</p> <important> <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p> </important>
MessageBodystring

The text body of the message.

MediaUrlsMediaUrlValue[]
<p>An array of URLs to each media file to send. </p> <p>The media files have to be stored in an S3 bucket. Supported media file formats are listed in <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/mms-limitations-character.html">MMS file types, size and character limits</a>. For more information on creating an S3 bucket and managing objects, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html">Creating a bucket</a>, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html">Uploading objects</a> in the <i>Amazon S3 User Guide</i>, and <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/send-mms-message.html#send-mms-message-bucket">Setting up an Amazon S3 bucket for MMS files</a> in the <i>Amazon Web Services End User Messaging SMS User Guide</i>.</p>
ConfigurationSetNamestring

The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.

MaxPricestring

The maximum amount that you want to spend, in US dollars, per each MMS message.

TimeToLiveinteger

How long the media message is valid for. By default this is 72 hours.

Contextobject

You can specify custom data in this field. If you do, that data is logged to the event destination.

DryRunboolean

When set to true, the message is checked and validated, but isn't sent to the end recipient.

ProtectConfigurationIdstring

The unique identifier of the protect configuration to use.

MessageFeedbackEnabledboolean

Set to true to enable message feedback for the message. When a user receives the message you need to update the message status using <a>PutMessageFeedback</a>.

Response

Success

MessageIdstring

The unique identifier for the message.