# 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-19. Web version: https://wrenform.com/docs/quick-forms

```sh
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"}'
```

```json
{
  "ok": true,
  "id": "k7Q2xw9Pz4mB",
  "endpoint": "https://wrenform.com/f/k7Q2xw9Pz4mB",
  "status": "pending_confirmation",
  "existing": false,
  "expiresAt": "2026-11-21T12:00:00.000Z",
  "snippet": { "framework": "html", "language": "html", "code": "<form action=…>…</form>", "notes": ["…"] },
  "nextSteps": ["Tell the user to check you@example.com for an email from Wrenform and click Confirm. …"]
}
```

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](/docs/claude-code), the
[MCP server](/docs/mcp) (`create_quick_form` on `/mcp/quick`) and the [prompts for AI builders](/docs/ai) 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

```sh
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](/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](/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](/docs/claude-code): `/wrenform:add-contact-form` does all of this in your project.
- [Prompts for AI builders](/docs/ai): ready-made prompts for Lovable, Bolt, v0, Cursor and others.
- [Spam](/docs/spam): how the filter works once the form is live.
