Skip to content
Wrenform

Docs

Quick start

Add a working form to any website in five minutes. No backend, no JavaScript required.

Last updated 2026-11-19View as Markdown
<form action="https://wrenform.com/f/YOUR_FORM_ID" method="POST">
  <input type="text" name="name" required>
  <input type="email" name="email" required>
  <textarea name="message" required></textarea>
  <input type="text" name="_honey" style="display:none" tabindex="-1" autocomplete="off">
  <button type="submit">Send</button>
</form>
<!-- Optional: a timing check against bots, and data-ajax to submit in place -->
<script src="https://wrenform.com/js/v1/form.js" defer></script>

Fastest path: tell your AI tool "add a contact form with Wrenform" (see AI tools). Or create a form in the dashboard, copy its action URL, and paste it into <form action="…" method="POST">.

Replace YOUR_FORM_ID with your form's ID. That's the whole integration.

1. Create a form

Sign in with your email or Google (it's free) and create a form. Copy its endpoint from the form's Setup page. It looks like https://wrenform.com/f/YOUR_FORM_ID. The form ID isn't a secret: it's meant to sit in your HTML.

Using a coding agent? It can't create the form for you. Create it yourself, then give the agent the form ID.

2. Paste the HTML

Set your form's action to the endpoint and its method to POST.

  • Give every input a name. Fields without one aren't sent.
  • Keep the hidden _honey field. Bots fill it in; people don't.
  • Name the address field email. It becomes the reply-to of the email you get.

3. Test it

Open your page, fill in the form and send it. You land on a thank-you page, the submission appears in your dashboard, and an email arrives at your sign-in address. You can also press Send test submission on the form's Setup page.

Send test submission checks that email arrives. It doesn't prove your live page works: deploy, then submit once from the real page. It should show up in your dashboard Inbox.

4. Lock it to your site

In the form's settings, add your site to Allowed origins, for example https://example.com, or https://*.example.com for its subdomains. Other sites then can't post to your form. While the list is empty, any site can.

Redirect or JSON

The endpoint answers in one of two modes, chosen per request:

  • Browser mode (a normal form post): on success, a 303 redirect to your thank-you page or ours. On error, a hosted error page with the same HTTP status. See redirects.
  • JSON mode: when the body is application/json, or the Accept header lists application/json before text/html. You get 200 with { "ok": true, "id": "…" }, or an error object with a stable code.
{ "ok": true, "id": "01JD3K2M9X7Q8R4T5V6W7Y8Z9A" }

Spam is answered exactly like success, so bots learn nothing. Accepted content types: application/x-www-form-urlencoded, multipart/form-data (text fields only; files are dropped) and application/json (a flat object).

Sending from JavaScript instead:

const res = await fetch("https://wrenform.com/f/YOUR_FORM_ID", {
  method: "POST",
  headers: { "Content-Type": "application/json", Accept: "application/json" },
  body: JSON.stringify({ name: "Ada", email: "ada@example.com", message: "Hello" }),
});
const result = await res.json();
// Success: { ok: true, id: "..." }
// Error:   { ok: false, error: { code, message, docs } }
if (!result.ok) console.error(result.error.code, result.error.message);

Limits

  • Request body: 64 KB. Up to 100 fields; names up to 100 characters; values up to 10,000 characters.
  • Rate limits: 10 a minute and 50 an hour per visitor and form; 60 a minute per form.
  • Monthly submissions: 250 on the free plan; see pricing. Past your quota, submissions are stored but not emailed.

More in fields and limits.

Error codes

Code HTTP Message
form_not_found 404 This form doesn't exist or has been deleted.
form_paused 403 This form isn't accepting messages right now.
form_suspended 410 This form has been suspended.
origin_not_allowed 403 This form doesn't accept messages from this website.
payload_too_large 413 The message is too large.
too_many_fields 422 The form has too many fields.
field_too_long 422 One of the fields is too long.
unsupported_media_type 415 The form was sent in a format we can't read.
invalid_json 422 The JSON body is invalid or nested.
empty_submission 422 The form was empty.
rate_limited 429 Too many messages. Please wait a minute and try again.
quota_exceeded 429 This form can't accept more messages this month.
form_pending_confirmation 429 This form is waiting for its owner to confirm it, and can't take more messages until then.
internal_error 500 Something went wrong on our side.

Common problems

  • Nothing arrives. Check that every input has a name, and that the form's method is POST.
  • origin_not_allowed. Your page's origin isn't in the allowed list, or you opened the HTML as a local file. Test from a web server.
  • The email went to spam. See notifications to allow-list our sender.
  • Something else. See my form isn't working: each symptom with its cause and fix.

Next steps

Something wrong or unclear on this page? Report a problem: write to hello [at] wrenform.com with the page address (/docs).