Text Message
—

https://app.ufirstbulksms.com/api/?username=your-username&password=your-password&message=test&sender=welcome&mobiles=2348030000000,2348020000000

Example Responses:

Success Response: {“status”:”OK”,”count”:1,”price”:2}

Failed Response: {“error”:”Login denied.”,”errno”:”103″}

Other optional Parameter

1. contacts = The list of contact ids to send the message

2. groups = The list of group ids to send the message

3. numbers = The list of number ids to send the message

4. type = The type (text, call, tts ) of the message

5. message = message text or audio reference number

Call Message
—

https://app.ufirstbulksms.com/api/?username=your-username&password=your-password&message=391000&sender=2348030000000&mobiles=2348020000000&type=call

Upload Audio

https://app.ufirstbulksms.com/api/?username=your-username&password=your-password&action=upload&url=app.ufirstbulksms.com/demo/sample,mp3

{“status”:”success”,”error”:””,”errno”:””,”data”:{“reference”:”ac798a79-f9e9-4662-c85b-f53ae1e62691″,”seconds”:22,”size”:”339.78KB”}}

Send TTS

https://app.ufirstbulksms.com/api/?username=your-username&password=your-password&message=welcome+to+trillion.&type=tts&sender=2348040000000&mobiles=2348030000000

{“status”:”success”,”error”:””,”errno”:””,”data”:{“f75cfaec-5565-2044-449a-71f474f9f7d7″:”2348030000000”}}

Send Audio

https://app.ufirstbulksms.com/api/?username=your-username&password=your-password&message=ac798a79-f9e9-4662-c85b-f53ae1e62691&type=call&sender=441120000000&mobiles=441130000000

{“status”:”success”,”error”:””,”errno”:””,”data”:{“b5703ef4-9730-c56e-d884-a314fe974cd6”:441130000000}}

Fetching Data
—

https://app.ufirstbulksms.com/api/?username=your-username&password=your-password&action=balance

Other Parameter

1. login = Perform account login to validate a user

2. profile = The customer profile of the account

3. balance = The current balance on the account

4. contacts = The type (text, call, tts ) of the message

5. numbers = The saved numbers on the account

6. groups = The groups on the account

7. audios = The saved audios on the account

8. history = The message history on the account

9. scheduled = The scheduled messages on the account

10. reports = The delivery reports on the account

11. payments = The payment history on the account

Error Codes:

000 = Request successful
100 = Incomplete request parameters
101 = Request denied

110 = Login status failed
111 = Login status denied

120 = Message limit reached
121 = Mobile limit reached
122 = Sender limit reached

130 = Sender prohibited
131 = Message prohibited

140 = Invalid price setup
141 = Invalid route setup
142 = Invalid schedule date

150 = Insufficient funds
151 = Gateway denied access
152 = Service denied access

160 = File upload error
161 = File upload limit
162 = File restricted

190 = Maintenance in progress
191 = Internal error