Skip to main content

Endpoint

POST https://app.sling.com.ng/api/v2/send-whatsapp
WhatsApp delivery requires an approved business sender on your account.

Headers

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

Body parameters

message
string
required
Message text content.
sender
string
required
Approved WhatsApp sender ID.
type
string
Sender ID route. Defaults to transactional.
callback
string
Public HTTPS URL that receives delivery updates.
reference
string
Custom message ID.
send_on
string
ISO datetime to schedule the message.
campaign_name
string
Label applied to multi-recipient campaigns.

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.

Response fields

status
string
"success" when the message is accepted.
message_id
string
Unique message ID. Use it with Message Status.
sender
string
Sender 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
400Sender not approved for WhatsApp