Send RCS Message API (File Upload)
Send RCS (File Upload) for SMSGatewayCenter APIs
Send RCS Message API (File Upload)
Use the Send RCS API to deliver RCS messages through SMSGatewayCenter using an approved template. This endpoint accepts POST requests and returns JSON. This page uses sendMethod=bulkupload. Send from a file of recipients.
Do not send live account usernames or passwords in public examples. Replace placeholders with your own credentials.
API Endpoint
https://unify.smsgateway.center/RCSApi/send
Authentication
Send userid (your account username) and password in the request body. RCS must be enabled on your account, and the botId must belong to that account.
| Parameter | Required | Description | Example/Value |
|---|---|---|---|
| Authentication | |||
| userid | Yes | Your SMSGatewayCenter account username. | YourUsername |
| password | Yes | Your account password. | ********** |
| Message Parameters | |||
| sendMethod | Yes | Set to bulkupload on this page. Allowed values: quick (one or more mobiles), group (saved contact group), or bulkupload (file upload). |
bulkupload |
| msgType | Yes | Message type. Use text for template-based RCS content. |
text |
| format | Yes | Response format. | json |
| botId | Yes | RCS bot identifier used to send the message. | YOUR_BOT_ID |
| msg | Yes | RCS payload JSON. Include contentMessage.templateMessage.templateCode and optional ttl. |
See sample request |
| phoneHeader | Yes | Column name in the upload file that contains mobile numbers. Required for bulkupload. |
Phone |
| customUpload | Yes | Set true for custom file upload. Required for bulkupload. |
true |
| identifier | Optional | Campaign identifier for your records. | api_campaign_001 |
Sample Request - File Upload (cURL)
curl --location --request POST 'https://unify.smsgateway.center/RCSApi/send' \
--form 'password={{PASSWORD}}' \
--form 'userid=YourUsername' \
--form 'sendMethod=bulkupload' \
--form 'msgType=text' \
--form 'format=json' \
--form 'botId={{botId}}' \
--form 'phoneHeader=Phone' \
--form 'customUpload=true' \
--form 'msg={
"contentMessage": {
"templateMessage": {
"templateCode": "WELCOME_TEMPLATE"
}
},
"ttl": "86400s"
}' \
--form 'identifier=api_campaign_001'Use multipart/form-data for file upload. The spreadsheet column named in phoneHeader must contain recipient numbers with country code.
Sample Success Response
{
"status": "success",
"mobile": "919999999999",
"invalidMobile": "",
"transactionId": "3983571817594375469",
"statusCode": "200",
"reason": "success",
"msgId": ""
}
Notes
- Use an approved template code in
msg.contentMessage.templateMessage.templateCode. ttlis the message time-to-live, for example86400sfor 24 hours.- Create and manage templates with the Create RCS Template API.
- List bots for your account with the RCS Bots REST API.
Testimonials
