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

FieldWhat it does
_gotchaHoneypot. Hide it; if a bot fills it, the submission goes to the spam folder.
redirectSend 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-responseAdded 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.

  1. Honeypot field filled
  2. Posted from a site that is not on the form’s allowed list (domain lock, optional)
  3. Disposable email address
  4. Turnstile failed (if on)
  5. Same message sent many times (campaign)
  6. 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.

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

StatusBodyMeaning
200ok: true, submission_idStored (inbox or spam folder)
302—Stored, then redirected to your thank-you page
400invalid_bodyBody could not be parsed
404form_not_foundWrong form ID
413payload_too_largeFields over 100 KB in total
415unsupported_media_typeNot form-encoded, multipart or JSON
429rate_limitedMore than 30 posts a minute from one IP to one form

Your data

Rolling out during the beta: Slack notifications and email from your own domain. Missing something? Request it.

Start free

See pricing →