API Guide / Getting Started / API error codes and description
API error codes and description

The Witly API uses status codes in the 200 range to indicate success, in the 400 range to indicate an error, and in the 500 range to indicate a server-side error. Most errors can be checked by the error response description.

Either when an error occurs or when a response is successful, the response header contains an HTTP code, and the response body usually contains:

  1. The HTTP response code
  2. The message accompanying the HTTP response code
  3. The error message (if the response returns information about an error)

HTTP response code



Success code for GET, POST, PUT or DELETE request.


The request couldn’t be understood, usually because the JSON or XML body contains an error.

  • The body of the request is in a format that's not supported by the specified method.
  • Content required
  • Incorrect integer value for field
  • Incorrect decimal value for field
  • Incorrect date/time value for field
  • Incorrect boolean value for field
  • Unknown data type for field
  • Invalid picklist/lookup value for field
  • Mandatory field required to update resource
  • No resource was matched with your criteria


The API requires authentication.


The request has been refused. The reasons are:

  • The access token has expired or is invalid. 
  • Requires secure connection (https).
  • Invalid username and password.


The requested API does not exist.


The request method is not allowed on the requested API.


An error has occurred within Witly.


The HTTP request method is not supported by the server.


Exceeded the concurrent connection limit.

Sample error message

The error response may return more than one error which includes error code and message.


Errors: [



"Message""Field ‘Customer Name’ not found"




"Message""Field ‘Customer Type’ not found"




"Message""Field ‘Subject’ is read only"




Last modified on Jan 23, 2018