Bulk SMS API Integration

(Sandbox Environment) Register and Login on the Sandbox Website to get your Sandbox API Key for the Sandbox Integration Click Here

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

On Sandbox environment the mobile number you are sending the bulk sms to must be 08011111111, 08022222222 any other mobile number that is not 08011111111, 08022222222 the bulk sms send request will fail.

cURL Init Sample


curl -X POST https://sandbox.vtunaija.com.ng/api/bulksms/ \ 

-H "Authorization: Token YOUR_API_KEY" \ 

-H "Content-Type: application/json" \ 

-d '{ 

    "sender": "BomaComes", 

    "number": "08011111111,08022222222,08011111111,08022222222", 

    "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. On Sandbox environment the mobile number you are sending the bulk sms to must be 08011111111, 08022222222 any other mobile number that is not 08011111111, 08022222222 the bulk sms send request will fail.

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