Send RCS Message

Send a RCS message immediately or schedule it for future delivery.

Requires an active RCS agent and recipient devices that support RCS Business Messaging.

Authentication

PINNACLE-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
TextobjectRequired
Send a text RCS message with optional quick reply buttons.
OR
MediaobjectRequired
Send a media RCS message with optional quick reply buttons.
OR
CardsobjectRequired
Send a cards RCS message with quick replies / buttons. - [Quick replies](/api-reference/messages/send-rcs#request.body.Cards.quickReplies) are shared across all cards in the carousel - While [buttons](/api-reference/messages/send-rcs#request.body.Cards.cards.buttons) resemble quick replies, they remain on screen after being clicked and are card-specific.

Response

Successfully sent or scheduled the message. Use our [/messages/:id](./get) endpoint to track your message. <Accordion title="About RCS Fallback SMS Response and RCS Fallback MMS Response"> Normally, when you send an RCS message with a fallback, the RCS message is attempted first — if delivery fails, the fallback SMS or MMS is sent afterward and you receive a `FALLBACK_SENT` webhook event. These response types are part of our new rollout that detects whether a recipient's phone is RCS-capable **before** the message is sent. If the phone does not support RCS, the fallback SMS or MMS is sent immediately — skipping the failed RCS attempt entirely. They can be ignored unless you have been specifically onboarded to use them. If you're interested, contact us at founders@trypinnacle.app. When you receive one of these responses, you will **not** receive a `FALLBACK_SENT` webhook event — the fallback was already sent in place of the RCS message. </Accordion>
RCS Sent Responseobject
OR
Scheduled Responseobject
OR
RCS Fallback SMS Responseobject
OR
RCS Fallback MMS Responseobject

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
501
Not Implemented Error