Messages > blast

Blast RCS to Audience

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

Messages are distributed evenly across the provided RCS agents for load balancing. Requires active RCS agents and recipient devices that support RCS Business Messaging. <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/rcs

Request

  • Base URL: https://api.pinnacle.sh
  • URL: https://api.pinnacle.sh/messages/blast/rcs
  • 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 RCS agent IDs to send from. Each must be prefixed with agent_. <br>

Messages will be evenly distributed across these agents.

Limit: 1 min

Response

Successfully queued or scheduled the RCS 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.