RCS API Integration Guide for Indian Businesses

REST API, webhooks, and a free sandbox for RCS Business Messaging — from ₹0.12 a message.

QUICK ANSWER

MetaReach's RCS API is a REST interface for sending rich cards, carousels, and suggested replies programmatically from your own app or CRM, with webhook callbacks for delivery and read status. There's a free sandbox to test integration before going live, automatic SMS fallback when a device doesn't support RCS, and pricing from ₹0.12 per message with no charge for API access or documentation.

FreeSandbox Access
₹0.12Per Message (Enterprise)
95%Open Rate
24x7API Uptime

What the RCS API Actually Does

Put simply, the RCS API is a REST interface that lets your own application send Rich Communication Services messages — rich cards, image carousels, suggested replies, the works — without anyone touching a dashboard. Instead of logging in to send a campaign one batch at a time, you trigger the message from inside a workflow: an order confirmation the second a payment clears, a delivery update the moment a shipment status changes, or a personalised offer fired off by something a user just did on your site.

It sits inside MetaReach's RCS Messaging (see RCS overview) platform and is structured a lot like our SMS API and WhatsApp Business API — so if your team has already wired up either of those, adding RCS on top is a fairly small lift.

What Happens Behind a Single API Call

Your system sends an HTTP request to MetaReach's endpoint with the recipient's number, the message content, and whatever interactive elements you're including. From there, MetaReach checks whether that number can actually receive RCS — and if it can't, the message falls back to plain SMS automatically, no extra code required on your side. The message goes out over whichever carrier the recipient is on — Jio, Airtel, or Vi — and once it's delivered or read, a webhook fires back to your system so you know exactly where things stand.

The Five Steps, End to End

  1. Authenticate — pass your API key in the request header.
  2. Check RCS capability (optional) — confirm the recipient's device supports RCS before you send anything rich.
  3. Send the message — POST your payload (text, rich card, or carousel) to the send endpoint.
  4. Receive the delivery receipt — a webhook lands on your configured URL with delivery or read status.
  5. Handle the fallback — if RCS isn't supported, the message drops back to SMS on its own.

Authenticating Your Requests

Every request is authenticated with an API key issued when you sign up, passed as a header on every call you make:

POST /v1/rcs/send HTTP/1.1
Host: api.metareachmarketing.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

What a Send Request Looks Like

Here's a basic rich-card send, stripped down to the essentials:

// POST https://api.metareachmarketing.com/v1/rcs/send
{
  "to": "+91XXXXXXXXXX",
  "message_type": "rich_card",
  "content": {
    "title": "Your order has shipped!",
    "description": "Track your package in real time.",
    "image_url": "https://example.com/shipment-image.jpg",
    "suggested_replies": ["Track Order", "Contact Support"]
  },
  "webhook_url": "https://yourapp.com/webhooks/rcs-status"
}

This is illustrative — the full request/response schema, error codes, and rate limits are in the complete API documentation, which you get access to after signing up for the sandbox.

Wiring It Into a CRM

Most teams end up hooking the RCS API into their CRM so messages fire directly off customer records — a rich-card appointment reminder the moment a lead's status changes, say, or a carousel of recommended products pulled from someone's purchase history. Delivery and read receipts sync straight back to the CRM through the webhook, so sales and support see message status without leaving the tool they already live in.

Getting Status Updates Without Polling

Set a webhook_url in your send request, or once in your account settings, and MetaReach posts a JSON payload to that URL every time a message is delivered, read, or fails — complete with a message ID, timestamp, and status code. That means your system finds out the moment something changes, instead of asking the API repeatedly and burning through quota for no reason.

A Few Things Worth Getting Right Early

  • Build for webhooks, not polling — polling is slower and chews through your API quota for no real benefit.
  • Run capability checks before anything high-value — confirm RCS support before sending rich, interactive content that would look flat as plain SMS.
  • Test in the sandbox first — validate formatting and webhook handling before any of it touches a real customer.
  • Write fallback-friendly copy — your message should still read fine as plain text on a device that doesn't support RCS.
  • Watch your rate limits — build retry logic with backoff if you're sending at volume.

What It Costs to Send

TierVolumePrice per Message
StarterUp to 5,000/month₹0.20
Business5,000 – 50,000/month₹0.15
Enterprise100,000+/month₹0.12

API access and documentation don't cost anything on top of that, on any tier. If you're still weighing RCS against SMS or WhatsApp for a given use case, the RCS pricing & comparison guide walks through where each one makes sense.

Frequently Asked Questions

It's a RESTful interface for sending RCS Business Messages — rich cards, carousels, suggested replies — straight from your own application, CRM, or backend, instead of a dashboard. It's built for developers and businesses wiring RCS into an automated workflow.

Yes. There's a free sandbox environment to test API calls, message formatting, and webhook delivery before anything goes live.

MetaReach posts a real-time webhook to a URL you configure whenever a message is delivered, read, or fails, so your system tracks status without repeatedly polling the API.

Pricing starts at ₹0.12 per message on the Enterprise tier (100,000+ messages a month), ₹0.15 on the Business tier (5,000-50,000 a month), and ₹0.20 on the Starter tier (up to 5,000 a month). API access and documentation are free on every tier.

Yes — trigger messages directly from customer records, sync delivery and read status back via webhook, and automate messaging around lead or order status changes.

Start Building with the RCS API Today

Free sandbox · Full documentation · No setup fee

WhatsApp Us Call +91-7669999219

Free Sandbox  |  Webhook Support  |  CRM-Ready  |  24x7 Uptime


Our Happy Clients

Trusted by 500+ Businesses Across India

From startups to enterprises — brands that grow with MetaReach


WhatsApp Facebook Instagram YouTube LinkedIn X / Twitter

☎ Instant Call Back FREE
or request a call back

We'll call you back within 5 minutes