API ReferenceMessages

Send MMS Message

Send a MMS immediately or schedule it for future delivery.

Authentication

PINNACLE-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.

At least one file or some text is required for sending MMS messages.

fromstringRequired
Phone number you want to send the message from in E.164 format.
mediaUrlslist of stringsRequired
Media file URLs to send.<br> See [supported media types](https://app.pinnacle.sh/supported-file-types?type=MMS).
textstringRequired
Message text to accompany the media.
tostringRequired
Recipient's phone number in E.164 format.
optionsobjectOptional
Control how your MMS is processed and delivered.

Response

Successfully sent or scheduled the message.

Each message part can be tracked independently using its unique message ID. Use our /messages/:id endpoint to track your messages.

MMS Sent Responseobject
OR
Scheduled Responseobject

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
501
Not Implemented Error