Differences

This shows you the differences between two versions of the page.

Link to this comparison view

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