Skip to content
Wrenform

Docs / Get started

Forms without an account

A working form from just an email address. Nothing is forwarded until that address confirms, and unconfirmed forms expire after 7 days.

Last updated 2026-11-19View as Markdown
curl -X POST https://wrenform.com/api/v1/quick-forms \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","siteUrl":"https://example.com","framework":"html"}'

No account, no API key, no sign-up form. One request with the address that should receive the messages returns a live endpoint and a ready-to-paste snippet. It's built for AI tools: the Claude Code plugin, the MCP server (create_quick_form on /mcp/quick) and the prompts for AI builders all use it.

How it works

  1. Create. Send POST /api/v1/quick-forms with email. Optional: siteUrl, the deployed https address (its origin becomes the form's only allowed origin; omit it before the site is deployed, and a localhost address is ignored), framework (which snippet to return: html, nextjs, react, vue, svelte, astro, hugo, jekyll and more) and name.
  2. Confirm. Wrenform emails that address once: "Confirm your contact form on Wrenform". The email says nothing the creator chose, so it can't be used to send someone a message. The person opens the link and clicks Confirm.
  3. Done. The form is live on the Free plan. Messages that arrived before confirming are delivered straight away.

Until the address confirms:

  • Messages are held, not forwarded: no email, no webhooks. Visitors still see your thank-you page.
  • Held messages are capped at 10 an hour and 50 in all. Past that, posts get 429 form_pending_confirmation.
  • Nothing counts against a plan.

If nobody confirms within 7 days, the form and its held messages are deleted. If the person clicks This wasn't me, everything is deleted at once, and that address gets no more confirmation emails.

Check the status

curl https://wrenform.com/api/v1/quick-forms/k7Q2xw9Pz4mB

The answer is only the status: pending_confirmation, active, expired or declined. Submissions and settings are never visible without signing in.

After confirming

The address owns a free Wrenform account with the form in it. To read messages, change settings or add a thank-you page, sign in at wrenform.com/sign-in with the same address. If the address already had an account, the form is simply added to it.

Limits

  • 5 quick forms an hour and 20 a day from one network, and 200 a day from one AI tool.
  • One pending form per address: asking again returns the same form with "existing": true and sends no second email.
  • One confirmation email per address per 24 hours.

Test it

  1. Create a quick form for an address you can read, and paste the snippet into a page.
  2. Send the form from the page. Your thank-you page shows, but no email arrives yet.
  3. Open the email from Wrenform and click Confirm. The held message arrives within a minute.
  4. GET /api/v1/quick-forms/<id> now says active.

Common problems

  • 422 address_unavailable. That address can't get a confirmation email: it declined before, it bounced, or it's a disposable address. Sign up at wrenform.com/sign-in instead, or use another address.
  • 429 rate_limited. Too many quick forms from this network or tool, or a confirmation went to this address in the last 24 hours. Wait, or sign up.
  • 503 quick_forms_unavailable. Quick forms are paused for a while to stop abuse. Try later, or sign up.
  • No confirmation email. Check the spam folder. Asking again within 24 hours doesn't send another.

Next steps

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