Skip to main content

​
Endpoint

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

​
Headers

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

​
Body parameters

​
sender
string
required
Approved RCS Sender ID.
​
type
string
Sender ID route. Accepted values: transactional or promotional. Defaults to transactional.
​
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 Suggestion object below.
​
standalone
object
Required when template_type is standalone.
​
carousel
array
Required when template_type is carousel.
​
callback
string
Public HTTPS URL that receives delivery updates.
​
reference
string
Custom message ID.
​
send_on
string
ISO datetime to schedule the message.

​
Recipient (provide exactly one)

​
to
string
Recipient phone number.
​
contact
string
Saved contact ID.
​
contacts
array
Array of saved contact IDs.
​
group
string
Single group ID.
​
groups
array
Array of group IDs.
​
numbers
string
Newline-separated raw phone numbers.

​
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"
}

​
Suggestion object

Use suggestions to add interactive chips. Every suggestion object includes:
FieldTypeRequiredDescription
typestringYesSuggestion type
textstringYesLabel shown on the chip
postbackstringYesValue sent back when the user taps the chip

​
Suggestion types

FieldTypeRequired
typestringYes, must be reply
textstringYes
postbackstringYes
{
  "type": "reply",
  "text": "Yes",
  "postback": "yes"
}
FieldTypeRequired
typestringYes, must be url
textstringYes
postbackstringYes
urlstringYes
{
  "type": "url",
  "text": "Open link",
  "postback": "open_link",
  "url": "https://example.com"
}
FieldTypeRequired
typestringYes, must be dialer
textstringYes
postbackstringYes
phonestringYes
{
  "type": "dialer",
  "text": "Call",
  "postback": "call",
  "phone": "0802222222"
}
FieldTypeRequired
typestringYes, must be location_latlng
textstringYes
postbackstringYes
latstringYes
lngstringYes
labelstringYes
{
  "type": "location_latlng",
  "text": "View location",
  "postback": "location",
  "lat": "6.5244",
  "lng": "3.3792",
  "label": "Sling HQ"
}
FieldTypeRequired
typestringYes, must be location_query
textstringYes
postbackstringYes
querystringYes
{
  "type": "location_query",
  "text": "Find us",
  "postback": "location",
  "query": "Sling Lagos Nigeria"
}
FieldTypeRequired
typestringYes, must be share_location
textstringYes
postbackstringYes
{
  "type": "share_location",
  "text": "Send location",
  "postback": "send_location"
}
FieldTypeRequired
typestringYes, must be calendar_event
textstringYes
postbackstringYes
datetimestringYes
titlestringYes
descriptionstringYes
{
  "type": "calendar_event",
  "text": "Save date",
  "postback": "save_date",
  "datetime": "2026-05-27T01:02",
  "title": "Sling Meeting",
  "description": "Meeting details"
}

​
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.
​
recipient
string
Normalized recipient phone number.
​
credit_used
number
Credits deducted for this message.

​
Error responses

StatusMeaning
400Missing or invalid request fields
400Insufficient credit
400This number is RCS disabled. You cannot send an RCS Message (when fallback is off)
400Sender not approved for RCS