Error Management

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

Error codeHttp status codeDetailsDescription
SERVER_ERROR500 Internal Server Error(varies)A problem with the server. Please try again later.
SERVICE_UNAVAILABLE503 Service Unavailable(varies)The server is currently too busy, taking too long to respond, or under maintenance. Please try again later.
THROTTLE_LIMITED429 Too Many RequestsAPI usage limit has been exceeded.A single API Key can only make a maximum of 2 requests per second.
NOT_FOUND404 Not FoundResource not foundThe API path does not exist.
UNAUTHORIZED401 UnauthorizedThe API key is invalid.Check if there is a typo in the API key, or if the API key has been deleted.
PAYMENT_REQUIRED402 Payment RequiredPlease upgrade to PRO or higher to use the API.The API is only available to PRO service users or higher.
NOT_FOUND_FORM404 Not FoundNon existing resource with id {form_id}The form_id cannot be found. Check for typos, or if the form has been deleted.
VALIDATION_ERRORS400 Bad Request(varies)The payload is incorrect. Check the fields and values in the payload and try again.
REACHED_MAX_WEBHOOKS422 Unprocessable EntityMaximum number of webhooks reachedA maximum of 10 webhooks can be created.
NOT_FOUND_WEBHOOK404 Not FoundNon existing resource with id {webhook_id}The webhook_id cannot be found. Check for typos, or if the webhook has been deleted.