When using our APIs you may receive an error code if you submit a request that cannot be processed. The error codes and what they mean are outlined below:
| Code |
Description |
Reason |
| 0 |
Unknown |
Send the full exception details to Esendex for more info. |
| 1 |
Unexpected |
Send the full exception details to Esendex for more info. |
| 2 |
Authentication Failed |
The username/password is invalid, or you are not permitted to access the account you specified. |
| 3 |
Missing Header |
The SOAP XML you posted was missing the SOAP Header when one was expected. |
| 4 |
Recipient Missing |
There was no recipient to send the message to. |
| 5 |
Account Not Live |
Your account has not started, or has expired. |
| 6 |
Method Not Enabled |
The method you called is not enabled. |
| 7 |
Feature Not Supported |
You tried to put a service alias on an message that doesn't support it. |
| 8 |
Message Not Found |
A message with the ID you specified could not be found. |
| 9 |
Recipient Invalid |
The recipient you entered was not a valid mobile number. |
| 10 |
Message Limit Exceeded |
You do not have enough credits to send the messages submitted. |
| 11 |
Message ID Format Invalid |
The ID you specified is not a valid GUID. |
| 12 |
Username Already Exists |
Reserved, |
| 13 |
Contact Already Exists |
You attempted to add a Contact with a name that already exists. |
| 14 |
Contact Group Already Exists |
You attempted to add a Contact Group with a name that already exists. |
| 15 |
Contact Or Group Already Exists |
You attempted to add a Contact Group and/or Contact with a name that already exists. |
| 16 |
Not Authorised |
You are not authorised to carry out the request submitted. |
| 17 |
Validation Error |
The contact or group you tried to create contains a field with invalid details. You will receive information on the field in error. |
| 18 |
No Active Subscription |
You attempted to send a premium rate message to a recipient who doesn't have an active subscription (someone who has not texted in, or has stopped their subscription). |
| 19 |
Invalid SubmitAt Error |
You attempted to submit a scheduled message at an invalid date/time. |
| 20 |
Subscription Not Found |
A subscription for the mobile number does not exist for this account. |