[{"data":1,"prerenderedAt":710},["ShallowReactive",2],{"navigation":3,"\u002Fguides\u002Fhtml-forms":176,"\u002Fguides\u002Fhtml-forms-surround":705},[4,40,100,152],{"title":5,"path":6,"stem":7,"children":8,"icon":39},"Getting started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,11,15,19,23,27,31,35],{"title":10,"path":6,"stem":7},"Introduction",{"title":12,"path":13,"stem":14},"How Postvia works","\u002Fgetting-started\u002Fhow-it-works","1.getting-started\u002F2.how-it-works",{"title":16,"path":17,"stem":18},"First customer and website","\u002Fgetting-started\u002Ffirst-customer-and-website","1.getting-started\u002F3.first-customer-and-website",{"title":20,"path":21,"stem":22},"Create your first form","\u002Fgetting-started\u002Ffirst-form","1.getting-started\u002F4.first-form",{"title":24,"path":25,"stem":26},"Submit your first JSON request","\u002Fgetting-started\u002Ffirst-json-request","1.getting-started\u002F5.first-json-request",{"title":28,"path":29,"stem":30},"Email notifications","\u002Fgetting-started\u002Femail-notifications","1.getting-started\u002F6.email-notifications",{"title":32,"path":33,"stem":34},"Test integration","\u002Fgetting-started\u002Ftest-integration","1.getting-started\u002F7.test-integration",{"title":36,"path":37,"stem":38},"Deploy integration","\u002Fgetting-started\u002Fdeploy-integration","1.getting-started\u002F8.deploy-integration","i-lucide-rocket",{"title":41,"icon":42,"path":43,"stem":44,"children":45},"Guides","i-lucide-book-open","\u002Fguides","2.guides",[46,48,52,56,60,64,68,72,76,80,84,88,92,96],{"title":41,"path":43,"stem":47},"2.guides\u002Findex",{"title":49,"path":50,"stem":51},"JavaScript integration","\u002Fguides\u002Fjavascript","2.guides\u002F1.javascript",{"title":53,"path":54,"stem":55},"Rate limits and retries","\u002Fguides\u002Frate-limits-retries","2.guides\u002F10.rate-limits-retries",{"title":57,"path":58,"stem":59},"Multiple recipients","\u002Fguides\u002Fmultiple-recipients","2.guides\u002F11.multiple-recipients",{"title":61,"path":62,"stem":63},"Success redirects","\u002Fguides\u002Fsuccess-redirects","2.guides\u002F12.success-redirects",{"title":65,"path":66,"stem":67},"Troubleshooting delivery","\u002Fguides\u002Ftroubleshooting-delivery","2.guides\u002F13.troubleshooting-delivery",{"title":69,"path":70,"stem":71},"TypeScript integration","\u002Fguides\u002Ftypescript","2.guides\u002F2.typescript",{"title":73,"path":74,"stem":75},"Nuxt 4 integration","\u002Fguides\u002Fnuxt","2.guides\u002F3.nuxt",{"title":77,"path":78,"stem":79},"Vue integration","\u002Fguides\u002Fvue","2.guides\u002F4.vue",{"title":81,"path":82,"stem":83},"Standard HTML forms","\u002Fguides\u002Fhtml-forms","2.guides\u002F5.html-forms",{"title":85,"path":86,"stem":87},"Turnstile integration","\u002Fguides\u002Fcloudflare-turnstile","2.guides\u002F6.cloudflare-turnstile",{"title":89,"path":90,"stem":91},"Validation errors","\u002Fguides\u002Fvalidation-errors","2.guides\u002F7.validation-errors",{"title":93,"path":94,"stem":95},"Successful submissions","\u002Fguides\u002Fsuccessful-submissions","2.guides\u002F8.successful-submissions",{"title":97,"path":98,"stem":99},"Prevent duplicates","\u002Fguides\u002Fpreventing-duplicates","2.guides\u002F9.preventing-duplicates",{"title":101,"path":102,"stem":103,"children":104,"icon":151},"API reference","\u002Fapi","3.api\u002F1.index",[105,107,111,115,119,123,127,131,135,139,143,147],{"title":106,"path":102,"stem":103},"API overview",{"title":108,"path":109,"stem":110},"Idempotency","\u002Fapi\u002Fidempotency","3.api\u002F10.idempotency",{"title":112,"path":113,"stem":114},"Security and spam protection","\u002Fapi\u002Fsecurity","3.api\u002F11.security",{"title":116,"path":117,"stem":118},"API playground","\u002Fapi\u002Fplayground","3.api\u002F12.playground",{"title":120,"path":121,"stem":122},"Base URLs and versioning","\u002Fapi\u002Fbase-urls-versioning","3.api\u002F2.base-urls-versioning",{"title":124,"path":125,"stem":126},"Submit form","\u002Fapi\u002Fsubmit-form","3.api\u002F3.submit-form",{"title":128,"path":129,"stem":130},"Short alias","\u002Fapi\u002Falias-endpoint","3.api\u002F4.alias-endpoint",{"title":132,"path":133,"stem":134},"Request headers","\u002Fapi\u002Frequest-headers","3.api\u002F5.request-headers",{"title":136,"path":137,"stem":138},"Request body","\u002Fapi\u002Frequest-body","3.api\u002F6.request-body",{"title":140,"path":141,"stem":142},"Response format","\u002Fapi\u002Fresponse-format","3.api\u002F7.response-format",{"title":144,"path":145,"stem":146},"Error codes","\u002Fapi\u002Ferrors","3.api\u002F8.errors",{"title":148,"path":149,"stem":150},"Rate limits","\u002Fapi\u002Frate-limits","3.api\u002F9.rate-limits","i-lucide-code-xml",{"title":153,"icon":154,"path":155,"stem":156,"children":157},"Resources","i-lucide-life-buoy","\u002Fresources","4.resources",[158,160,164,168,172],{"title":153,"path":155,"stem":159},"4.resources\u002Findex",{"title":161,"path":162,"stem":163},"Frequently asked questions","\u002Fresources\u002Ffaq","4.resources\u002F1.faq",{"title":165,"path":166,"stem":167},"Troubleshooting","\u002Fresources\u002Ftroubleshooting","4.resources\u002F2.troubleshooting",{"title":169,"path":170,"stem":171},"API changelog","\u002Fresources\u002Fchangelog","4.resources\u002F3.changelog",{"title":173,"path":174,"stem":175},"Migration guides","\u002Fresources\u002Fmigrations","4.resources\u002F4.migrations",{"id":177,"title":81,"apiOperation":178,"body":179,"description":700,"extension":701,"links":178,"meta":702,"navigation":248,"path":82,"related":178,"seo":703,"stem":83,"__hash__":704},"docs\u002F2.guides\u002F5.html-forms.md",null,{"type":180,"value":181,"toc":695},"minimark",[182,191,604,609,616,619,623,626,673,680,684,691],[183,184,185,186,190],"p",{},"No JavaScript is required for a basic form. The browser posts URL-encoded data and receives a ",[187,188,189],"code",{},"303"," redirect on success.",[192,193,198],"pre",{"className":194,"code":195,"language":196,"meta":197,"style":197},"language-html shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cscript src=\"https:\u002F\u002Fchallenges.cloudflare.com\u002Fturnstile\u002Fv0\u002Fapi.js\" async defer>\u003C\u002Fscript>\n\n\u003Cform action=\"https:\u002F\u002Fapi.postvia.dev\u002Fv1\u002Fforms\u002Fabc123\u002Fsubmissions\" method=\"POST\">\n  \u003Clabel>Name \u003Cinput name=\"name\" autocomplete=\"name\" required>\u003C\u002Flabel>\n  \u003Clabel>Email \u003Cinput name=\"email\" type=\"email\" autocomplete=\"email\" required>\u003C\u002Flabel>\n  \u003Clabel>Message \u003Ctextarea name=\"message\" required>\u003C\u002Ftextarea>\u003C\u002Flabel>\n\n  \u003Cdiv hidden>\n    \u003Cinput name=\"_honeypot\" tabindex=\"-1\" autocomplete=\"off\">\n  \u003C\u002Fdiv>\n\n  \u003Cdiv class=\"cf-turnstile\" data-sitekey=\"YOUR_SITE_KEY\" data-action=\"contact\">\u003C\u002Fdiv>\n\n  \u003Cbutton type=\"submit\">Send\u003C\u002Fbutton>\n\u003C\u002Fform>\n","html","",[187,199,200,243,250,284,337,393,433,438,451,495,505,510,559,564,595],{"__ignoreMap":197},[201,202,205,209,213,217,220,223,227,229,232,235,238,240],"span",{"class":203,"line":204},"line",1,[201,206,208],{"class":207},"sMK4o","\u003C",[201,210,212],{"class":211},"swJcz","script",[201,214,216],{"class":215},"spNyl"," src",[201,218,219],{"class":207},"=",[201,221,222],{"class":207},"\"",[201,224,226],{"class":225},"sfazB","https:\u002F\u002Fchallenges.cloudflare.com\u002Fturnstile\u002Fv0\u002Fapi.js",[201,228,222],{"class":207},[201,230,231],{"class":215}," async",[201,233,234],{"class":215}," defer",[201,236,237],{"class":207},">\u003C\u002F",[201,239,212],{"class":211},[201,241,242],{"class":207},">\n",[201,244,246],{"class":203,"line":245},2,[201,247,249],{"emptyLinePlaceholder":248},true,"\n",[201,251,253,255,258,261,263,265,268,270,273,275,277,280,282],{"class":203,"line":252},3,[201,254,208],{"class":207},[201,256,257],{"class":211},"form",[201,259,260],{"class":215}," action",[201,262,219],{"class":207},[201,264,222],{"class":207},[201,266,267],{"class":225},"https:\u002F\u002Fapi.postvia.dev\u002Fv1\u002Fforms\u002Fabc123\u002Fsubmissions",[201,269,222],{"class":207},[201,271,272],{"class":215}," method",[201,274,219],{"class":207},[201,276,222],{"class":207},[201,278,279],{"class":225},"POST",[201,281,222],{"class":207},[201,283,242],{"class":207},[201,285,287,290,293,296,300,302,305,308,310,312,315,317,320,322,324,326,328,331,333,335],{"class":203,"line":286},4,[201,288,289],{"class":207},"  \u003C",[201,291,292],{"class":211},"label",[201,294,295],{"class":207},">",[201,297,299],{"class":298},"sTEyZ","Name ",[201,301,208],{"class":207},[201,303,304],{"class":211},"input",[201,306,307],{"class":215}," name",[201,309,219],{"class":207},[201,311,222],{"class":207},[201,313,314],{"class":225},"name",[201,316,222],{"class":207},[201,318,319],{"class":215}," autocomplete",[201,321,219],{"class":207},[201,323,222],{"class":207},[201,325,314],{"class":225},[201,327,222],{"class":207},[201,329,330],{"class":215}," required",[201,332,237],{"class":207},[201,334,292],{"class":211},[201,336,242],{"class":207},[201,338,340,342,344,346,349,351,353,355,357,359,362,364,367,369,371,373,375,377,379,381,383,385,387,389,391],{"class":203,"line":339},5,[201,341,289],{"class":207},[201,343,292],{"class":211},[201,345,295],{"class":207},[201,347,348],{"class":298},"Email ",[201,350,208],{"class":207},[201,352,304],{"class":211},[201,354,307],{"class":215},[201,356,219],{"class":207},[201,358,222],{"class":207},[201,360,361],{"class":225},"email",[201,363,222],{"class":207},[201,365,366],{"class":215}," type",[201,368,219],{"class":207},[201,370,222],{"class":207},[201,372,361],{"class":225},[201,374,222],{"class":207},[201,376,319],{"class":215},[201,378,219],{"class":207},[201,380,222],{"class":207},[201,382,361],{"class":225},[201,384,222],{"class":207},[201,386,330],{"class":215},[201,388,237],{"class":207},[201,390,292],{"class":211},[201,392,242],{"class":207},[201,394,396,398,400,402,405,407,410,412,414,416,419,421,423,425,427,429,431],{"class":203,"line":395},6,[201,397,289],{"class":207},[201,399,292],{"class":211},[201,401,295],{"class":207},[201,403,404],{"class":298},"Message ",[201,406,208],{"class":207},[201,408,409],{"class":211},"textarea",[201,411,307],{"class":215},[201,413,219],{"class":207},[201,415,222],{"class":207},[201,417,418],{"class":225},"message",[201,420,222],{"class":207},[201,422,330],{"class":215},[201,424,237],{"class":207},[201,426,409],{"class":211},[201,428,237],{"class":207},[201,430,292],{"class":211},[201,432,242],{"class":207},[201,434,436],{"class":203,"line":435},7,[201,437,249],{"emptyLinePlaceholder":248},[201,439,441,443,446,449],{"class":203,"line":440},8,[201,442,289],{"class":207},[201,444,445],{"class":211},"div",[201,447,448],{"class":215}," hidden",[201,450,242],{"class":207},[201,452,454,457,459,461,463,465,468,470,473,475,477,480,482,484,486,488,491,493],{"class":203,"line":453},9,[201,455,456],{"class":207},"    \u003C",[201,458,304],{"class":211},[201,460,307],{"class":215},[201,462,219],{"class":207},[201,464,222],{"class":207},[201,466,467],{"class":225},"_honeypot",[201,469,222],{"class":207},[201,471,472],{"class":215}," tabindex",[201,474,219],{"class":207},[201,476,222],{"class":207},[201,478,479],{"class":225},"-1",[201,481,222],{"class":207},[201,483,319],{"class":215},[201,485,219],{"class":207},[201,487,222],{"class":207},[201,489,490],{"class":225},"off",[201,492,222],{"class":207},[201,494,242],{"class":207},[201,496,498,501,503],{"class":203,"line":497},10,[201,499,500],{"class":207},"  \u003C\u002F",[201,502,445],{"class":211},[201,504,242],{"class":207},[201,506,508],{"class":203,"line":507},11,[201,509,249],{"emptyLinePlaceholder":248},[201,511,513,515,517,520,522,524,527,529,532,534,536,539,541,544,546,548,551,553,555,557],{"class":203,"line":512},12,[201,514,289],{"class":207},[201,516,445],{"class":211},[201,518,519],{"class":215}," class",[201,521,219],{"class":207},[201,523,222],{"class":207},[201,525,526],{"class":225},"cf-turnstile",[201,528,222],{"class":207},[201,530,531],{"class":215}," data-sitekey",[201,533,219],{"class":207},[201,535,222],{"class":207},[201,537,538],{"class":225},"YOUR_SITE_KEY",[201,540,222],{"class":207},[201,542,543],{"class":215}," data-action",[201,545,219],{"class":207},[201,547,222],{"class":207},[201,549,550],{"class":225},"contact",[201,552,222],{"class":207},[201,554,237],{"class":207},[201,556,445],{"class":211},[201,558,242],{"class":207},[201,560,562],{"class":203,"line":561},13,[201,563,249],{"emptyLinePlaceholder":248},[201,565,567,569,572,574,576,578,581,583,585,588,591,593],{"class":203,"line":566},14,[201,568,289],{"class":207},[201,570,571],{"class":211},"button",[201,573,366],{"class":215},[201,575,219],{"class":207},[201,577,222],{"class":207},[201,579,580],{"class":225},"submit",[201,582,222],{"class":207},[201,584,295],{"class":207},[201,586,587],{"class":298},"Send",[201,589,590],{"class":207},"\u003C\u002F",[201,592,571],{"class":211},[201,594,242],{"class":207},[201,596,598,600,602],{"class":203,"line":597},15,[201,599,590],{"class":207},[201,601,257],{"class":211},[201,603,242],{"class":207},[605,606,608],"h2",{"id":607},"success-redirect","Success redirect",[183,610,611,612,615],{},"The API redirects to the form’s configured HTTPS success URL. If none is configured, it redirects to the hosted thank-you page at ",[187,613,614],{},"https:\u002F\u002Fapi.postvia.dev\u002Fthanks",".",[183,617,618],{},"The redirect URL is validated when saved. Postvia never redirects to a URL supplied by the visitor.",[605,620,622],{"id":621},"idempotency-for-html-forms","Idempotency for HTML forms",[183,624,625],{},"Use the reserved field if you need safe retries without JavaScript:",[192,627,629],{"className":194,"code":628,"language":196,"meta":197,"style":197},"\u003Cinput type=\"hidden\" name=\"_idempotency_key\" value=\"550e8400-e29b-41d4-a716-446655440000\">\n",[187,630,631],{"__ignoreMap":197},[201,632,633,635,637,639,641,643,646,648,650,652,654,657,659,662,664,666,669,671],{"class":203,"line":204},[201,634,208],{"class":207},[201,636,304],{"class":211},[201,638,366],{"class":215},[201,640,219],{"class":207},[201,642,222],{"class":207},[201,644,645],{"class":225},"hidden",[201,647,222],{"class":207},[201,649,307],{"class":215},[201,651,219],{"class":207},[201,653,222],{"class":207},[201,655,656],{"class":225},"_idempotency_key",[201,658,222],{"class":207},[201,660,661],{"class":215}," value",[201,663,219],{"class":207},[201,665,222],{"class":207},[201,667,668],{"class":225},"550e8400-e29b-41d4-a716-446655440000",[201,670,222],{"class":207},[201,672,242],{"class":207},[183,674,675,676,679],{},"Do not combine a different ",[187,677,678],{},"Idempotency-Key"," header with this field. Conflicting values are rejected.",[605,681,683],{"id":682},"errors","Errors",[183,685,686,687,690],{},"Native form errors render a generic, accessible HTML page. The page never echoes private input. For field-level errors, use a JavaScript integration and read the JSON ",[187,688,689],{},"422"," response.",[692,693,694],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":197,"searchDepth":245,"depth":245,"links":696},[697,698,699],{"id":607,"depth":245,"text":608},{"id":621,"depth":245,"text":622},{"id":682,"depth":245,"text":683},"Post a native HTML form and use the configured success redirect.","md",{},{"title":81,"description":700},"R6dVf8Tvjv8AYmPo67ToAqevwlpKohLYWsMF3FDGE-Q",[706,708],{"title":77,"path":78,"stem":79,"description":707,"children":-1},"Use a small Vue composable around the public submission contract.",{"title":85,"path":86,"stem":87,"description":709,"children":-1},"Render the widget, send the token and handle verification failures correctly.",1795377933187]