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.
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
- Create. Send
POST /api/v1/quick-formswithemail. Optional:siteUrl, the deployed https address (its origin becomes the form's only allowed origin; omit it before the site is deployed, and alocalhostaddress is ignored),framework(which snippet to return:html,nextjs,react,vue,svelte,astro,hugo,jekylland more) andname. - 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.
- 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/k7Q2xw9Pz4mBThe 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": trueand sends no second email. - One confirmation email per address per 24 hours.
Test it
- Create a quick form for an address you can read, and paste the snippet into a page.
- Send the form from the page. Your thank-you page shows, but no email arrives yet.
- Open the email from Wrenform and click Confirm. The held message arrives within a minute.
GET /api/v1/quick-forms/<id>now saysactive.
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
- Claude Code plugin:
/wrenform:add-contact-formdoes all of this in your project. - Prompts for AI builders: ready-made prompts for Lovable, Bolt, v0, Cursor and others.
- Spam: how the filter works once the form is live.