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. |