API ReferenceSend a Message

MMS Message

Send an MMS message with media attachments.

Authentication

PINNACLE-API-Keystring
Pinnacle API Key

Request

MMS message details such as recipient phone number, sender phone number, message content, and media URLs.
tostringRequiredformat: "^\+\d{11}$"

The recipient’s phone number in E.164 format (e.g., +12345678901).

fromstringRequiredformat: "^\+\d{11}$"
The sender's phone number in E.164 format. Must be owned by the user.
mediaUrlslist of stringsRequired

The URLs of media to include. jpeg, jpg, gif, and png file types are fully supported and have a size limit of 5 MB. 500 KB limit for other types. Up to 10 media URLs can be included.

textstringOptional<=1600 characters

The MMS message content (max 1600 characters).

statusCallbackstringOptionalformat: "uri"

Optional URL to receive a POST request when the message status changes. Read more about status callbacks here.

Response

MMS message sent successfully
messageIdstring
The unique ID of the sent message.
messagestring
A message indicating the status of the sent message.

Errors