API ReferenceReference
Errors
Every error the endpoint can return, what causes it and how to fix it.
| Status | Message | Cause and fix |
|---|---|---|
400 | Missing access key | No access_key field and no key in the URL. Add the hidden field. |
400 | Invalid access key | The key is not a valid UUID. Copy it again from the Connect tab. |
400 | Submission is empty | Every field was blank. Check your inputs have name attributes. |
400 | Please complete the captcha. | The form has a captcha but no token was sent. See reCAPTCHA or Turnstile. |
400 | Captcha verification failed. Please try again. | The token was invalid, expired, already used, or the reCAPTCHA v3 score was too low. |
403 | Form is disabled | The form is turned off in your dashboard. |
403 | This form doesn’t accept submissions from this website. | The form is restricted to other domains, or the request had no Origin/Referer. |
404 | Form not found | No form uses this key. It may have been deleted. |
413 | Submission is too large | The body is over 100 KB. Send files with file uploads, not in text fields. |
429 | Too many submissions. Please try again later. | More than 5 submissions from one IP to this form in 10 minutes. |
500 | Internal server error | Something went wrong on our side. Try again; contact support if it continues. |
503 | We couldn’t verify the captcha. Please try again. | Google or Cloudflare didn’t respond in time. The visitor can simply resubmit. |
Script-only errors
| Message | Cause |
|---|---|
| Configuration error: a valid Formclick access key is required… | formclick.min.js found no hidden access_key field, or the value is not a UUID. |
| “cv.pdf” exceeds the 5 MB size limit. | A file is larger than 5 MB. |
| “photo.heic” is not an accepted file type. | The file does not match the input’s accept attribute. |
Honeypot hits and duplicate submissions return success on purpose, so bots and double-clicks get no signal.
Still need help? Contact support or email support@formclick.io.