The Hubtel SMS API uses standard HTTP error reporting. Successful requests return HTTP status codes in the 2xx. Failed requests return status codes in 4xx and 5xx. Error responses are included in the JSON response body, which contains information about the error.
| Code | Subcode | Description |
|---|---|---|
| 200 | The request was successful and the message has been sent for onward delivery. | |
| 201 | 0 | The request was successful and the message has been sent for onward delivery |
| 100 | General invalid request. Returned when no data is sent or a malformed request is received. | |
| 1 | Invalid Destination address received. The recipient's phone number is not a valid phone number | |
| 2 | Invalid Source address was sent. You need to be aware of the sender address restrictions. | |
| 3 | The message body was too long. | |
| 400 | 4 | The message is not routable on Hubtel gateway |
| 5 | The delivery time specified was not a valid time. | |
| 6 | The message content was rejected or is invalid. | |
| 7 | One or more parameters are not allowed in the message. Details will be provided as part of the response. | |
| 8 | One or more parameters are not valid for the message. Details will be provided as part of the response. | |
| 12 | Payment required on account; Kindly fund your account | |
| 401 | The request authorization failed. | |
| 402 | Your account does not have enough messaging credit to send the message. | |
| 403 | Forbidden. It means that the recipient has not given his/her approval to receive messages. | |
| 404 | The specified message was not found. | |
| 500 | The request failed on the server. | |
| 502 | Bad Gateway. The server could not find any appropriate gateway for the request. |