Error Management

If an error occurs during an API request, please refer to the following error codes and their contents.

Error code Http status code Details Description
SERVER_ERROR 500 Internal Server Error (varies) A problem with the server. Please try again later.
SERVICE_UNAVAILABLE 503 Service Unavailable (varies) The servers are currently too busy, or the response is taking too long. Please try again later.
THROTTLE_LIMITED 429 Too Many Requests API usage limit has been exceeded. A single API Key can only make a maximum of 2 requests per second.
NOT_FOUND 404 Not Found Resource not found The API path does not exist.
UNAUTHORIZED 401 Unauthorized The API key is invalid. Check if there is a typo in the API key, or if the API key has been deleted.
PAYMENT_REQUIRED 402 Payment Required Please upgrade to PRO or higher to use the API. The API is only available to PRO service users or higher.
NOT_FOUND_FORM 404 Not Found Non existing resource with id {form_id} The form_id cannot be found. Check for typos, or if the form has been deleted.
VALIDATION_ERRORS 400 Bad Request (varies) The payload is incorrect. Check the fields and values in the payload and try again.
REACHED_MAX_WEBHOOKS 422 Unprocessable Entity Maximum number of webhooks reached A maximum of 10 webhooks can be created.
NOT_FOUND_WEBHOOK 404 Not Found Non existing resource with id {webhook_id} The webhook_id cannot be found. Check for typos, or if the webhook has been deleted.