Common Errors

This page outlines common errors you may encounter when using the SMS API and how to resolve them.

Invalid Credentials

Error Code: 1006

Issue: The API key or Partner ID provided is incorrect or has expired.

Solution: Double-check your API key and Partner ID. Regenerate the API key from your account settings if needed.

Invalid Mobile Number

Error Code: 1003

Issue: The mobile number format is invalid or not recognized.

Solution: Ensure the mobile number is in the correct format (e.g., 254xxxxxxxx for Kenya). Remove any spaces, dashes, or special characters.

Invalid Sender ID

Error Code: 1001

Issue: The shortcode used is invalid or not assigned to your account.

Solution: Verify that you're using the correct shortcode assigned to your account.

Low Bulk Credits

Error Code: 1004

Issue: Your account does not have sufficient SMS credits to send the message.

Solution: Check your balance using the SMS Balance endpoint and purchase additional credits from your account.

Network Not Allowed

Error Code: 1002

Issue: The mobile number's network is not supported or allowed for your account.

Solution: Contact support to enable additional networks or use supported networks only.

System Error

Error Code: 1005, 1007, 4090

Issue: An internal system error has occurred.

Solution: Wait a few moments and retry your request. If the error persists, contact support.

No Delivery Report Available

Error Code: 1008

Issue: No delivery report is available for the queried message ID.

Solution: Wait a few moments for the delivery report to be generated and try again. Ensure the message ID is correct.

Unsupported Data Type

Error Code: 1009

Issue: The data type provided is not supported.

Solution: Verify that all parameters are of the correct type (strings for text, integers for numbers, etc.).

Unsupported Request Type

Error Code: 1010

Issue: The request method or format is not supported.

Solution: Use GET or POST methods as specified in the API documentation.

Too Many Messages in List

Error Code: 1012

Issue: The bulk SMS request contains more than the maximum allowed messages (1000).

Solution: Split your request into multiple batches of up to 1000 messages each.

Too Many Comma-Separated Contacts

Error Code: 1104

Issue: The number of comma-separated mobile numbers exceeds the limit.

Solution: Use the Bulk SMS endpoint for multiple recipients or split the request.

Missing Partner ID

Error Code: 4091

Issue: The Partner ID parameter is missing from the request.

Solution: Include the partnerID parameter in your request.

Missing API Key

Error Code: 4092

Issue: The API key parameter is missing from the request.

Solution: Include the apikey parameter in your request.

Details Not Found

Error Code: 4093

Issue: The requested resource or information was not found.

Solution: Verify that the message ID, phone number, or other identifiers are correct.

Last Updated: 2/24/2025 | Contributors: Macrologic API Team