This shows you the differences between two versions of the page.
api-errors [2015/10/22 12:47] ben [Error List] |
api-errors [2017/07/26 08:24] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== API Errors ====== | ||
- | 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. | ||
- | |||
- | ==== Example ==== | ||
- | |||
- | <code> | ||
- | 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" | ||
- | } | ||
- | </code> | ||
- | |||
- | ===== Error List ===== | ||
- | |||
- | |||
- | |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.| | ||
- | |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.| |