Skip to main content

​
Endpoint

POST https://app.sling.com.ng/api/v1/send-rcs

​
Headers

HeaderValue
Acceptapplication/json
AuthorizationBearer {API_TOKEN}
Content-Typeapplication/json

​
Body parameters

​
sender
string
required
Registered Sender ID.
​
to
string
required
Recipient phone number. Accepts local format, country code, or + prefix.
​
type
string
required
Sender ID route. Accepted values: transactional or promotional.
​
template_type
string
required
RCS content type. Accepted values: text, standalone, or carousel.
​
message
string
Text message body. Required when template_type is text.
​
fallback_sms
boolean
default:"false"
When true, Sling falls back to SMS if the recipient does not support RCS.
​
fallback_sms_sender
string
Sender ID used for the SMS fallback when fallback_sms is true. For example, Sling while your RCS sender is RCS.
​
suggestions
array
Interactive suggestion chip objects. See RCS Suggestions.
​
standalone
object
Required when template_type is standalone.
​
carousel
array
Required when template_type is carousel.

​
SMS fallback

Set fallback_sms to true and Sling will re-send the message as a standard SMS if the recipient does not support RCS. Use fallback_sms_sender to set the SMS Sender ID for that fallback (for example, Sling when your RCS sender is RCS).
{
  "sender": "RCS",
  "to": "08140363541",
  "message": "Hello from Sling",
  "type": "transactional",
  "template_type": "text",
  "fallback_sms": true,
  "fallback_sms_sender": "Sling"
}

​
Response fields

​
status
string
"success" when the message is accepted.
​
message_id
string
Unique message ID. Use it with Message Status.
​
sender
string
Sender ID used for delivery.
​
message
string
Text content for text messages.
​
recipient
string
Normalized recipient phone number.
​
credit_used
number
Credits deducted for this message.

​
Error responses

StatusMeaning
400Missing or invalid request fields
400Insufficient credit