Messages > blast

Blast MMS to Audience

Send an MMS message to all contacts in an audience. <br>

Messages are distributed evenly across the provided sender phone numbers. <br>

Use the optional schedule parameter in options to schedule the blast for future delivery. When scheduled, the response will contain a scheduleId instead of blast details.

post/messages/blast/mms

Request

  • Base URL: https://api.pinnacle.sh
  • URL: https://api.pinnacle.sh/messages/blast/mms
  • Auth: API key in header PINNACLE-API-KEY

Request body

audienceIdstring required

The audience ID to send the blast to. This identifier is a string that always begins with the prefix aud_, for example: aud_abc123. <br>

You can create an audience via the dashboard or API.

sendersstring[] required

Array of phone numbers to send from in E.164 format. <br>

Messages will be distributed evenly across these senders.

Note: Sandbox numbers cannot be used for blasts.

Limit: 1 min

Response

Successfully queued or scheduled the MMS blast. <br>

  • Immediate blast: Returns blast details including total recipients, messages, segments, and cost.
  • Scheduled blast: Returns a scheduleId and the schedule configuration.
OR

Changes

No recorded changes to this operation across all 1 revision of this API.