If you signed up before Aug 9, 2021, please click Previous plans to view your applicable plans.

In Freshdesk, error codes may appear during various interactions and processes, indicating specific issues or anomalies that need attention. Understanding these error codes and their reasons can help diagnose and resolve the underlying problems efficiently. Below are some common error codes encountered in Freshdesk and the reasons they may occur:


HTTP STATUS CODETEXTDESCRIPTION
200
OK

The request was successful, and the server responded with the requested data.

201
Created

The request was successful, and a new resource was created.

204
No Content
The request was successful, but there is no content to send in the response.
400Client or Validation ErrorThe request body/query string is not in the correct format. For example, the Create a ticket API requires the requester_id field to be sent as part of the request and if it is missing, this status code is returned.
401Authentication FailureIndicates that the Authorization header is either missing or incorrect. You can learn more about the Authorization header here.
403Access DeniedThis indicates that the agent whose credentials were used in making this request was not authorized to perform this API call. It could be that this API call requires admin level credentials or perhaps the Freshdesk portal doesn't have the corresponding feature enabled. It could also indicate that the user has reached the maximum number of failed login attempts or that the account has reached the maximum number of agents
404Requested Resource not FoundThis status code is returned when the request contains invalid ID/Freshdesk domain in the URL or an invalid URL itself. For example, an API call to retrieve a ticket with an invalid ID will return a HTTP 404 status code to let you know that no such ticket exists.
405Method not allowedThis API request used the wrong HTTP verb/method. For example, an API PUT request on /api/v2/tickets endpoint will return a HTTP 405 as /api/v2/tickets allows only GET and POST requests.
406Unsupported Accept HeaderOnly application/json and */* are supported.
When uploading files multipart/form-data is supported.
409Inconsistent/Conflicting StateThe resource that is being created/updated is in an inconsistent or conflicting state. For example, if you attempt to Create a Contact with an email that is already associated with an existing user, this code will be returned.
415Unsupported Content-typeContent type application/xml is not supported. Only application/json is supported.
429Rate Limit ExceededThe API rate limit allotted for your Freshdesk domain has been exhausted.
500Unexpected Server ErrorPhew!! You can't do anything more here. This indicates an error at Freshdesk's side. Please email us your API script along with the response headers. We will reach you out to you and fix this ASAP.
502Bad Gateway

The server, while acting as a gateway or proxy, received an invalid response from the upstream server.

503
Service Unavailable

The server is not ready to handle the request, possibly due to maintenance or overload.

504
Gateway Timeout
The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server.