Logo
Logo
Talk Now

Trusted by 10,000+ businesses

Developer Documentation

RCS Messaging API for Businesses

Send rich cards, carousels, and text messages programmatically. REST endpoints, webhook-based delivery and read-receipt tracking, and automatic SMS fallback- built for CRM and app integration.

Node.js, Python, PHP, and Java SDKs available

RCS API integration- rich card message on mobile phone

Written by the Get Click Media Pvt. Ltd. Team · Last updated: July 2026 · Reviewed by the Get Click Media engineering team

Trusted by 10,000+ businesses across India

GD Goenka
Bada Business
NexusPay
Salary Now
IBG Network
Niramaya Healthcare
Smart Realty
Evanik
Radius
Logic Education
HeliPkg
Acer Labs
VisionTech
Teleopedia
Shipline
Max Labs
Ini Homes
Cashi
Prime Dental
WWICS
GD Goenka
Bada Business
NexusPay
Salary Now
IBG Network
Niramaya Healthcare
Smart Realty
Evanik
Radius
Logic Education
HeliPkg
Acer Labs
VisionTech
Teleopedia
Shipline
Max Labs
Ini Homes
Cashi
Prime Dental
WWICS

The Get Click Media RCS API is a REST API for sending rich cards, carousels, and plain-text RCS messages from your own app or CRM, with webhooks for delivery status and read receipts, and automatic SMS fallback for devices that don't support RCS. It follows the same RCS Business Messaging model documented in Google's official RCS Business Messaging API reference.

Authentication

API Key Generation

Every request is authenticated with an API key issued when your account is provisioned, passed as a bearer token in the request header.

Authorization header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
REST API Examples

Send a Message via the RCS API

Illustrative request format- your onboarding contact confirms exact field names and base URL for your account before you go live.

Send a Rich Card Message

POST /v1/rcs/messages
curl -X POST https://api.getclickmedia.com/v1/rcs/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+9198XXXXXXXX",
    "type": "rich_card",
    "richCard": {
      "title": "Flash Sale- 30% Off",
      "imageUrl": "https://cdn.example.com/sale-banner.jpg",
      "description": "Today only. Tap below to shop the sale.",
      "actions": [
        { "type": "openUrl", "label": "Shop Now", "url": "https://example.com/sale" }
      ]
    }
  }'

Send a Carousel Message

POST /v1/rcs/messages
curl -X POST https://api.getclickmedia.com/v1/rcs/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+9198XXXXXXXX",
    "type": "carousel",
    "cards": [
      { "title": "Product A", "imageUrl": "https://cdn.example.com/a.jpg",
        "actions": [{ "type": "openUrl", "label": "View", "url": "https://example.com/a" }] },
      { "title": "Product B", "imageUrl": "https://cdn.example.com/b.jpg",
        "actions": [{ "type": "openUrl", "label": "View", "url": "https://example.com/b" }] }
    ]
  }'
Webhooks

Delivery Status & Read Receipt Webhooks

Register a webhook URL to receive real-time delivery-status and read-receipt events, instead of polling the API for status updates.

Delivery status webhook payload
{
  "event": "message.delivered",
  "messageId": "msg_9f2a1c",
  "to": "+9198XXXXXXXX",
  "status": "delivered",
  "channel": "rcs",
  "timestamp": "2026-07-01T10:15:00Z"
}

Delivery Status Webhook

Fires when a message is sent, delivered, falls back to SMS, or fails- with a timestamp and reason.

Read Receipt Webhook

Fires when the recipient opens the message inside Google Messages, for engagement tracking.

Delivery Reports

Illustrative RCS API Endpoints

In addition to webhooks, you can poll message status directly by ID- useful for reconciliation jobs and dashboards.

  • POST /v1/rcs/messages

    Purpose
    Send a message (text / rich card / carousel)
  • GET /v1/rcs/messages/{id}

    Purpose
    Check delivery status of a sent message
  • POST /v1/rcs/webhooks

    Purpose
    Register a delivery-status or read-receipt webhook
RCS API Best Practices

Building a Reliable RCS Integration

Store your API key securely

Keep your API key server-side only- never ship it in client-side/mobile app code.

Always handle the SMS-fallback case

Check the delivery-status webhook for a fallback event so your app can log or route it correctly.

Use webhooks, not polling

Register delivery and read-receipt webhooks instead of repeatedly polling the message-status endpoint.

Validate payloads before sending

Malformed rich-card or carousel JSON is the most common cause of send failures- validate structure client-side first.

Design for rate limits

Batch sends and back off on 429 responses rather than retrying immediately in a tight loop.

Monitor delivery rate, not just send success

A 200 response means the request was accepted- track the delivery webhook to confirm the message actually reached the device.

Google RCS

Largest CPaaS partner for RCS API Integration

Get Click Media enables developers to send rich cards, carousels, and track delivery programmatically with RCS.

Business communication banner

One message could
change your business.

Big or small, we power communication for all- talk to us today.

Product Interested
Frequently Asked Questions

RCS API for Developers

Yes- a REST API for sending rich cards, carousels, and text messages, with webhook support for delivery and read-receipt status.

Ready to integrate RCS into your app?

Talk to our integration team for API access, full endpoint documentation, and SDK support.