Any request made to the Sentori API that cannot be completed successfully will result in a 4xx HTTP status code. The response body will contain a JSON object giving more details about the specific error; a unique error code and a human readable message.
HTTP/1.1 403 Forbidden
Cache-Control: private
Content-Type: application/json; charset=utf-8
Date: Sat, 1 Jan 2000 00:00:00 GMT
Content-Length: 79
{
"Code":1,
"Message":"API Key not valid"
}
| API Code | API Message | HTTP Status | Description |
| -1 | Bad request | 400 | The API request is malformed. |
| 1 | API Key not valid | 403 | The specified API doesn't have access to any Sentori Accounts. |
| 2 | Failed to set account | 403 | The API Key appears valid but the Sentori Account cannot be accessed. |
| 3 | Account not found | 403 | The API Key appears valid but the Sentori Account doesn't appear to exist. |
| 100 | Email Address not valid | 400 | The Email Address in the request isn't a valid email address. |
| 101 | Contact not found | 404 | The Contact specified in the request couldn't be found in the Sentori Account |
| 102 | Email Address already in use | 400 | The Email Address in the request is already in use by another Contact. |
| 103 | Contact Fields not valid | 400 | The Contact Fields (or their values) in the request are not valid for this Sentori Account. |
| 104 | Email Addresses not valid | 400 | The Email Address in the request URI and body must match. |
| 105 | No Email Address found in Contacts | 400 | Contact Import could not find the Email Address field. |
| 106 | Email Address is Suppressed | 400 | The Email Address appears on the Account's Suppression List. |
| 107 | Email Address marked as Bad | 400 | The Email Address matches a Contact that is marked as having a Bad Email Address. |
| 200 | Mailing List not found | 404 | The Mailing List specified in the request couldn't be found in the Sentori Account. |
| 300 | Document not found | 404 | The Document could not be found in the Sentori Account. |
| 301 | Document is not of expected type | 400 | The Document is not of the expected type. e.g. was expecting an Email but Document is an SMS. |
| 302 | Link not found | 404 | The specified Link was not found. |
| 400 | Email is not a draft | 400 | Email is not in a draft state. |
| 401 | Email name already in use | 409 | The specified Email name is already in use. |
| 500 | Audience not found | 404 | The specified Audience/Upload Group could not be located in the Sentori Account. |
| 600 | Automation not found | 404 | The Automation was not found. |
| 601 | Only Autoresponders are supported | 400 | Only Autoresponders can be used in this context. |
| 602 | Contact not added as Automation is stopped | 400 | The Automation is stopped so the Contact wasn't added to it. |
| 603 | Contact already completed non-Repeatable Automation | 409 | The Contact has already completed the Automation which is set as non-Repeatable so they will not be added again. |
| 604 | Contact already active in Automation | 409 | The Contact is already in the Automation so cannot be added again until they finish it. |