Docs / Reference
My form isn't working
Stalled at setup? Find your step, S1 to S4, with a 3-step fix. Otherwise find your symptom in the table, change the recipient, or get a missing confirmation email.
{
"ok": false,
"error": {
"code": "origin_not_allowed",
"message": "This form doesn't accept messages from this website.",
"docs": "https://wrenform.com/docs/errors#origin_not_allowed"
}
}A rejected submission names a code. Find it in the table. No code and no email? See below.
Stalled at setup?
Find the step you stopped at.
S1: No form yet
You signed up, but there is no form, so no URL to post to.
- Sign in and create a form.
- Copy the action URL from its Setup page into your
<form>, withmethod="POST". Or ask your AI tool. - Deploy, and submit once from the live page.
S2: Recipient not confirmed
Submissions are kept, but nothing is emailed until the recipient confirms.
- Find the email "Confirm you want form submissions from Wrenform", also in spam.
- Open its link and confirm.
- Not there? Resend it.
S3: Form ready, no submission
The form isn't on your live site, or the site is refused.
- Paste the full action URL, not a relative one, and deploy.
- Add your site's origin to Allowed origins, or leave it empty.
- Submit from the live page, not a local file.
S4: Only test submissions
A test proves email delivery, not that your page works.
- Deploy the page with the form.
- Submit once from it.
- Nothing arrives? Check the Spam tab, then the table below.
Symptom, cause, fix
| Symptom | Cause | Fix |
|---|---|---|
origin_not_allowed |
The page isn't in the form's Allowed origins. Local files (file://) and sandboxed frames always fail; with allowed origins set, so does a Referrer-Policy: no-referrer page. |
Add your site's origin under Allowed origins and test from a web server. Keep the default referrer policy, or add <meta name="referrer" content="strict-origin-when-cross-origin">. |
A CORS error in the browser console, no code |
With fetch, a refused origin gets no CORS headers. |
Fix Allowed origins. Send only the Content-Type and Accept headers; others fail the preflight. |
form_not_found |
The form ID in the action URL is wrong, or the form was deleted. | Copy the action URL again from the form's Setup page. |
empty_submission |
No field had a value, usually because the inputs have no name. |
Give every input a name. Fields without one aren't sent. |
form_pending_confirmation |
A form created without an account is still waiting for its recipient, and has held all it can. | Click Confirm in the email from Wrenform. Held messages are then emailed. See quick forms. |
| The submission is in the dashboard, but no email | The recipient hasn't confirmed, the email went to spam, the form's emails are off, or you're over quota. | See below. A typo? Change the recipient. |
| Nothing in the dashboard Inbox | The submission was judged spam, or the form posts somewhere else. | Open the form's Spam tab. Check the form's action and method. |
The confirmation email never arrived
- Check spam for an email from
hello [at] wrenform.com. At work, ask your admin to allowwrenform.com. - Misspelled? Change the recipient.
- Press Resend next to the address, under Recipients in the form's settings: 3 times a day; the link works for 7 days.
- "Disabled"? It bounced or unsubscribed. Press Re-verify on your Recipients page.
On confirmation, the 20 most recent submissions from the last 7 days are emailed. More in notifications.
Change the recipient
- In the form's settings, under Recipients, press Remove from form next to the old address. Free allows one recipient per form, so remove it first.
- Add the new address under Add a recipient.
- The new address gets a confirmation email. Nothing is emailed to it until it's confirmed.
Remove a misspelled address on your Recipients page. Your sign-in email can't be removed: untick it on the form.
Allowed origins must match exactly
https://example.com matches https://example.com only
https://www.example.com add it too if your site also answers on www
https://*.example.com any subdomain, but not example.com itself
http://localhost:4321 local testing (http only for localhost)
https://example.com/contact refused: no path
example.com refused: needs https://An origin is the scheme and host, no path; www. makes a different origin.
Test it
Send test submission, on the form's Setup page, checks email only. Then submit once from your live page and look in the Inbox.
Common problems
- It worked, then stopped. A recipient unsubscribed or bounced (see your Recipients page), or you passed your monthly quota (see Billing and usage).
- A real message is in Spam. Select it in the Spam tab and click Not spam. It moves to the Inbox; no email is sent for it. If it keeps happening, lower the spam sensitivity.
- The form posts to your own site. A relative
actionor a framework handler sends it to your server. Use the full URL. - Everything lands in Spam as "Honeypot". The hidden
_honeyfield was filled, often by browser autofill or a visible field. Keep it hidden, empty, withautocomplete="off".
Next steps
- Quick start: set up a form.
- AI tools: let your AI tool add the form.
- Errors: every code and its fix.
- Still stuck? Write to hello [at] wrenform.com with the
X-Request-Idfrom the response.