API ReferenceOverview
API overview
Everything a Formclick form does goes through a small, public HTTP API. Use it directly from any language.
The Formclick Submission API accepts form submissions from browsers, mobile apps and servers. It is the same API that plain HTML forms and formclick.min.js use, so anything a form can do, your code can do.
| Endpoint | Purpose |
|---|---|
POST https://api.formclick.io/submit | Create a submission. See Submit endpoint. |
POST https://api.formclick.io/preupload | Get a one-time upload URL for a file. See File upload API. |
| Your webhook URL | Formclick calls you with each new submission. See Webhook events. |
Base URL
https://api.formclick.ioQuick example
curl -X POST https://api.formclick.io/submit \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"access_key":"YOUR_ACCESS_KEY","name":"Jane","email":"jane@example.com","message":"Hello"}'{ "success": true, "message": "Thank you! Your message has been received." }Conventions
- All endpoints use HTTPS. Plain HTTP is not supported.
- Requests and responses are JSON unless noted. The submit endpoint also accepts form-encoded bodies.
- Every response carries
success: trueorsuccess: false. Errors include a readablemessage. - CORS is open to every origin, so you can call the API straight from the browser.
Managing forms programmatically
Need to list forms, read submissions or create forms? Use the OAuth-based REST API, the Make app (coming soon) or, for AI assistants, the MCP server.
Still need help? Contact support or email support@formclick.io.