For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDashboard
DocsAPI ReferenceWebhooksMethodsUI ComponentsMCP ServerChangelog
  • Documentation
    • Introduction
    • Authentication
    • RCS Support
  • Quickstart
    • SMS
    • RCS
  • Guides
    • Purchase Phone Numbers
    • Brands
    • Campaigns
    • Messages
      • Sending Messages
      • Receiving Messages and User Events
      • Rate Limits
    • Branded Test Agents
    • Handling Expired URLs
LogoLogo
SupportDashboard
On this page
  • Channels at a glance
  • Before you send
  • Send in three steps
  • Next up
Guides

Messaging Overview

Was this page helpful?
Previous

Sending Messages

Next
Built with

Connect with customers on their preferred channels while managing every aspect of your messaging lifecycle through Pinnacle. Begin with our sending guide to get started quickly, then expand your capabilities with advanced message status tracking and inbound message handling as your needs grow.

Send messages

Build SMS, MMS, and RCS experiences — including blasts, reactions, and typing indicators.

Receive replies

Set up webhooks, track message statuses, and process inbound messages and user events.

Channels at a glance

ChannelBest forSenderHighlights
SMSAlerts, 2FA, concise notifications10DLC or toll-free numberInstant reach, text only
MMSRich promotions, media-heavy updates10DLC or toll-free numberImages, GIFs, PDFs alongside text
RCSInteractive journeys, commerce flowsApproved RCS agentCards, rich media, buttons, quick replies, read receipts

Before you send

  • Numbers or agent credentials. Purchase a number or get an agent ID by registering an RCS campaign.
  • Campaign approval. Ensure each number is attached to an active 10DLC/toll-free campaign, or your RCS agent is approved.
  • API access. Create an API key on the Pinnacle Dashboard and store it securely.
Optional: Validate first

Use POST /messages/validate/sms, POST /messages/validate/mms, and POST /messages/validate/rcs to allow you to validate content without sending. This will help you catch unsupported files, return media size, display segmentation, and give cost estimates before hitting send.

Send in three steps

1

Compose

Craft the SMS, MMS, or RCS message to be sent.
2

Deliver

Use the respective send endpoint/method.

  • SMS: POST /messages/send/sms.
  • MMS: POST /messages/send/mms.
  • RCS: POST /messages/send/rcs.
3

Track

Poll GET /messages/{messageId} to get updates for your message or subscribe to webhooks to monitor status changes and inbound replies. See our receiving guide for more details.

Next up

  • Keeping track of conversations? Explore the Conversations API.
  • Want to broadcast to an audience? See Blasts in the sending guide.
  • Need to react to messages with emoji? See Reactions.
  • Ready to receive messages, message statuses, and user events? Continue to our receiving guide.