This is an old revision of the document!

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

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"
}

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