API ReferenceSend a Message

MMS Message

Send an MMS message with media attachments.

Headers

PINNACLE-API-KeystringRequired

Request

This endpoint expects an object.
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).

statusCallbackstringOptional

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