× Integration Introduction page Airtime API Documentation Data API Documentation Cable TV API Documentation Electricity API Documentation Bulk SMS API Documentation Data Pin API Documentation Exam Pin API Documentation Internet Bundles API Documentation Recharge Card Pin API Documentation

Bulk SMS API Integration

(Live Environment)

Welcome to the Bulk SMS API Integration page. This guide will help you integrate our Bulk SMS API into your system.

cURL Init Sample

curl -X POST https://vtunaija.com.ng/api/bulksms/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sender": "BomaComes",
"number": "08012345678,09087345432,07098758748,08075869874",
"message": "Merry Christmas and a Happy New Year! Thank you for choosing Boma Enterprise this year. We look forward to continuing to serve you in the future."
}'

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "Message Sent",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "34"
}

Failed API Response

{
"Status": "failed",
"status": "fail",
"api_response": "Transaction Fail",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0"
}

Post Terms Defined and Interpreted

sender: This represents the name or business name of the user sending the bulk SMS.

number: This field contains the phone numbers to which the user is sending the bulk SMS. If sending to multiple phone numbers, separate each number with a comma. Phone numbers can be formatted as either 2348187587897 or 08187587897.

message: This field contains the content of the SMS message the user wishes to send via bulk SMS.