Quickstart
FormRill gives any HTML form an endpoint. No server, no JavaScript, no build step. This page covers everything that is live in the open beta.
1. Create a form
Sign up free with your email (magic link, no password), pick the EU or US data region, then create a form. You get an endpoint like https://api.formrill.com/f/frm_xxxx.
2. Point your form at it
Set the form’s action to your endpoint and method to POST. Keep your own field names and design.
<form action="https://api.formrill.com/f/frm_xxxx" method="POST">
<input name="name" />
<input name="email" type="email" required />
<textarea name="message"></textarea>
<!-- honeypot: bots fill it, people never see it -->
<input type="text" name="_gotcha" hidden />
<!-- optional: where to send people after they submit -->
<input type="hidden" name="redirect" value="https://yoursite.com/thanks" />
<button>Send</button>
</form> This works the same in Astro, Hugo, Jekyll, Eleventy, Next.js, Webflow, Framer, Lovable and Bolt: anything that renders a form.
3. Send a test
Submit the form once. The submission shows up in your dashboard within seconds. localhost always passes the domain lock, so you can test before you deploy.
Special fields
| Field | What it does |
|---|---|
_gotcha | Honeypot. Hide it; if a bot fills it, the submission goes to the spam folder. |
redirect | Send people to this URL after they submit. You can also set a default per form. If the form has allowed sites set, the redirect must point at one of them. |
cf-turnstile-response | Added by the Cloudflare Turnstile widget. Turn Turnstile on per form in its settings. |
These fields are not stored with the submission. Everything else is.
Spam checks
Each submission runs these checks, cheapest first. A flagged submission goes to the spam folder. It is never forwarded, never billed and never deleted except by your retention setting. One click moves it back to your inbox.
- Honeypot field filled
- Posted from a site that is not on the form’s allowed list (domain lock, optional)
- Disposable email address
- Turnstile failed (if on)
- Same message sent many times (campaign)
- Email domain that cannot receive mail
Notifications
In each form’s settings, add any of these. They fire for inbox submissions only, never for spam. If one fails, the submission is still stored in your dashboard.
- Email: every field plus a link to the submission.
- Webhook: a JSON POST to your URL (10 s timeout).
- Google Sheets: one row per submission on the sheet’s first tab. Share the sheet as Editor with the address shown in settings, then paste its URL. Row 1 becomes the headers (
Submitted atplus your field names), and a new field adds a new column.
POST https://your-endpoint
content-type: application/json
user-agent: FormRill-Webhook/1
{
"form_id": "frm_...",
"form_name": "Contact",
"submission_id": "sub_...",
"created_at": "2026-11-14T12:14:19.000Z",
"data": { "email": "[email protected]", "message": "We need a quote." },
"url": "https://app.formrill.com/forms/frm_...?s=sub_..."
} Sending with JavaScript
The endpoint accepts application/x-www-form-urlencoded, multipart/form-data (file parts are ignored) and application/json. Without a redirect it answers with JSON.
const res = await fetch("https://api.formrill.com/f/frm_xxxx", {
method: "POST",
body: new FormData(form),
});
const body = await res.json();
// { "ok": true, "submission_id": "sub_..." } curl -X POST "https://api.formrill.com/f/frm_xxxx" \
-H "content-type: application/json" \
-d '{"email":"[email protected]","message":"We need a quote."}' Responses
| Status | Body | Meaning |
|---|---|---|
| 200 | ok: true, submission_id | Stored (inbox or spam folder) |
| 302 | — | Stored, then redirected to your thank-you page |
| 400 | invalid_body | Body could not be parsed |
| 404 | form_not_found | Wrong form ID |
| 413 | payload_too_large | Fields over 100 KB in total |
| 415 | unsupported_media_type | Not form-encoded, multipart or JSON |
| 429 | rate_limited | More than 30 posts a minute from one IP to one form |
Your data
- Submissions are stored in the region you picked at signup (EU or US). It can’t be changed later.
- Kept until you delete them, or set a retention period per form; old ones are removed nightly.
- CSV export per form. Privacy requests: find one person’s submissions across every form, then export or erase them.
Rolling out during the beta: Slack notifications and email from your own domain. Missing something? Request it.
Start free