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.

Send Bulk SMS API Request 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.", 

    "request-id": "287980ak9u7i798" 
          
}'

Successful Send Bulk SMS API Response Example

This is an example of the response returned for a successful Bulk SMS Submission


{ 
  
    "Status": "successful", 

    "status": "success", 

    "api_response": "Message Sent", 

    "id": "78977865523", 

    "ident": "78977865523", 

    "plan_amount": "34.00", 

    "transaction_internal_id": "9439" 

}

Failed Send Bulk SMS API Response Example

This is an example of the response returned for a failed Bulk SMS Submission


{ 

    "Status": "failed", 

    "status": "fail", 

    "api_response": "Transaction Fail", 

    "id": "78977865523", 

    "ident": "78977865523", 

    "plan_amount": "0.00", 

    "transaction_internal_id": "9439" 

}

Processing Send Bulk SMS API Response Example

This is an example of the response returned for a pending Bulk SMS Submission.


{ 

    "Status": "processing", 

    "status": "processing", 

    "api_response": "Pending Bulk SMS Submission, transaction pending",

    "id": "78977865523", 

    "ident": "78977865523", 

    "plan_amount": "34.00", 

    "transaction_internal_id": "9439" 
       
}

Failed Send Bulk SMS API Response Example

This is an example of a failed API response caused by factors such as an insufficient wallet balance, an incorrect API key, missing POST fields and so on.


{ 

    "Status": "failed", 
 
    "status": "fail", 

    "message": "Insufficient wallet balance", 
         
              
}

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.

request-id: This is the unique ID you send as the Request ID.