Skip to main content

​
Endpoint

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

​
Headers

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

​
Body parameters

​
to
string
required
Recipient phone number. Accepts local format (without country code, where applicable), country code without +, or E.164 with + prefix — for example 08012345678, 2348012345678, +2348012345678, or +14155552671.
​
message
string
required
Message text. Maximum 3 pages.
​
sender
string
required
Registered Sender ID or brand name.
​
type
string
Sender ID route. Accepted values: transactional or promotional.
​
callback
string
Public HTTPS URL that receives delivery updates.
​
instant
boolean
default:"false"
When true, the request waits for immediate processing. When false, the message is queued.
​
fallback_sms
boolean
default:"false"
When true, Sling falls back to SMS if the message cannot be delivered over Truecaller.
​
fallback_sms_sender
string
Sender ID used for the SMS fallback when fallback_sms is true. For example, Sling while your Truecaller sender is Brand.
​
contact
string
Saved contact ID. Use instead of to.
​
group
string
Contact group ID. Use instead of to.

​
SMS fallback

Set fallback_sms to true and Sling will re-send the message as a standard SMS if delivery over Truecaller is not possible. Use fallback_sms_sender to set the SMS Sender ID for that fallback (for example, Sling when your Truecaller sender is Brand).
{
  "sender": "Brand",
  "to": "08140363233",
  "message": "Hello from Truecaller",
  "type": "transactional",
  "fallback_sms": true,
  "fallback_sms_sender": "Sling"
}

​
URL parameters

This endpoint also supports URL-based sending with api_token, to, message, and sender as query parameters. 
https://app.sling.com.ng/api/v1/send-truecaller?api_token=YOUR_API_TOKEN&to=08140363233&message=Hello&sender=Brand

​
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 or brand name used for delivery.
​
message
string
Message text.
​
recipient
string
Normalized recipient phone number.
​
credit_used
number
Credits deducted for this message.

​
Error responses

StatusMeaning
400Missing or invalid request fields
400Insufficient credit