The Gorgias API uses conventional HTTP response codes to indicate the success or failure of an API request.
The request succeeded. Everything worked as expected.
The request is invalid. Mainly due to:
The request was not authenticated. Mainly due to:
Read Authentication section to know how to authenticate your requests.
The API token provided does not have the permissions to perform the request. This is mainly due to the role associated with the user performing the request.
The requested resource does not exist. It can be a ticket, a customer, etc... Most of the time, it means that the resource has been deleted.
The request tried to create or update a resource with an identifier already in use. E.g: Attempting to create a customer with an email address already used by another customer.
Payload Too Large
The request failed because the payload is too large. Most of the time, it means that you've attempted to upload files above the size limit.
Too Many Requests
The request failed because you performed too many requests in a period of time. In such scenario, you need to retry later.
The request is valid but something when wrong on our side. These are rare.