RCS Panel API
The RCS Panel (rcs.msgai.in) is the self-service surface for
RCS-only customers — separate from the partner API and the app
panel. If you signed up at the RCS Panel you can use this API to do
everything the UI does: design templates, upload contact lists, run
broadcasts, recharge your wallet, and pull dashboard stats.
Base URL: https://api.msgai.in
Route: /api/v1/rcs/*
Auth: Authorization: Bearer <jwt>Authentication
RCS Panel auth is JWT-based and separate from the partner pk_live_…
keys. You exchange your email + password for a JWT and pass it on
every subsequent request.
Sign in
POST /api/v1/rcs/auth/login
Content-Type: application/json
{
"email": "you@yourbrand.com",
"password": "your-password"
}Response:
{
"success": true,
"token": "eyJhbGciOiJIUzI1Ni...",
"expires_in": 604800
}The token is valid for 7 days. Re-login any time before it expires; there is no refresh-token endpoint.
Using the token
All endpoints under /api/v1/rcs/* (except /auth/*) require:
Authorization: Bearer eyJhbGciOiJIUzI1Ni...A missing or expired token returns 401 with
{"success": false, "message": "unauthorized"}.
Account status gates
Some endpoints will return 403 until your account is fully
provisioned:
| State | Trigger |
|---|---|
pending | Signed up, awaiting Route Mobile credentials |
active | Admin has assigned your bot name + credentials |
suspend | Account suspended by admin |
Broadcasts are blocked until your account is active AND your wallet
has enough balance to cover the first message.
Errors
Every error response is shaped as:
{ "success": false, "message": "human-readable explanation" }HTTP codes used:
| Code | Meaning |
|---|---|
| 400 | Bad request (invalid body, missing field, garbage values) |
| 401 | Missing / expired / invalid JWT |
| 403 | Account state or wallet check failed |
| 404 | Resource not found or not owned by you |
| 409 | Conflict (e.g. starting a broadcast that’s already running) |
| 500 | Server error — open a support ticket with the response body |
What’s next
- Templates — create + list + delete templates
- Contact lists — manage recipient lists
- Broadcasts — schedule and run sends
- Wallet & Recharge — Zoho Payments integration
- Invoices — list + download PDFs
- Dashboard stats — KPIs and daily series