Errors
Voxtelesys provides error details, if applicable, to your callback URL via an error field. The error field provides a unique code identifying the error and is primarily intended to help you self-diagnose the issue.
Voxtelesys uses an error schema that is comprised of a 4 digit code. The first digit is used to determine if the error was caused by the client (customer) or server. The remaining 3 digits are error specific codes.
- Client Errors (
4xxx):- Voxtelesys Rejected, or
- Carrier Rejected
- Server Errors (
5xxx):- Voxtelesys Rejected, or
- Carrier Rejected
Client Errors
A 4xxx error code indicates that Voxtelesys or the downstream carrier has identified some element of the email request to be unacceptable. Repeating the request will produce the same result. The exceptions are 4503 and 4504, which are temporary rejections by the recipient's mail server, so a later send may succeed.
| Code | Description | Rejection Source |
|---|---|---|
| 4101 | invalid email body | Voxtelesys |
| 4102 | invalid email to | Voxtelesys |
| 4103 | invalid email from | Voxtelesys |
| 4104 | 24hr message count exceeded | Voxtelesys |
| 4501 | recipient address does not exist | Carrier |
| 4502 | recipient domain does not accept email | Carrier |
| 4503 | recipient mailbox full | Carrier |
| 4504 | recipient server temporarily rejected email | Carrier |
| 4505 | recipient server permanently rejected email | Carrier |
| 4506 | recipient server rejected email after delivery | Carrier |
| 4507 | rejected as spam | Carrier |
| 4508 | rejected for sender reputation | Carrier |
| 4509 | rejected by recipient policy | Carrier |
| 4510 | recipient suppressed after a bounce | Carrier |
| 4511 | recipient suppressed after a spam complaint | Carrier |
| 4512 | recipient suppressed after an unsubscribe | Carrier |
Server Errors
A 5xxx error code indicates that either Voxtelesys or the downstream carrier has reported a service failure. For Voxtelesys failures, the customer can retry the request and expect a different result. For downstream carrier errors, a retry may also yield a different result.
| Code | Description | Rejection Source |
|---|---|---|
| 5300 | internal error | Voxtelesys |
| 5301 | internal error | Voxtelesys |
| 5302 | internal error | Voxtelesys |
| 5303 | internal error | Voxtelesys |
| 5306 | internal error | Voxtelesys |
| 5307 | internal error | Voxtelesys |
| 5308 | internal error | Voxtelesys |
| 5312 | internal error | Voxtelesys |
| 5313 | internal error | Voxtelesys |
| 5314 | internal error | Voxtelesys |
| 5351 | internal error | Voxtelesys |
| 5352 | internal error | Voxtelesys |
| 5353 | internal error | Voxtelesys |
| 5354 | internal error | Voxtelesys |
| 5355 | internal error | Voxtelesys |
| 5101 | carrier service unavailable | Carrier |
| 5102 | carrier service error | Carrier |
| 5103 | carrier rate limit exceeded | Carrier |