[{"data":1,"prerenderedAt":573},["ShallowReactive",2],{"navigation":3,"\u002Fguides\u002Fvalidation-errors":176,"\u002Fguides\u002Fvalidation-errors-surround":568},[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":89,"apiOperation":178,"body":179,"description":562,"extension":563,"links":178,"meta":564,"navigation":565,"path":90,"related":178,"seo":566,"stem":91,"__hash__":567},"docs\u002F2.guides\u002F7.validation-errors.md",null,{"type":180,"value":181,"toc":557},"minimark",[182,191,368,373,492,495,527,531,546,550,553],[183,184,185,186,190],"p",{},"The API returns ",[187,188,189],"code",{},"422 validation_failed"," when a form-configured required field is missing or a field is not allowed.",[192,193,198],"pre",{"className":194,"code":195,"language":196,"meta":197,"style":197},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"validation_failed\",\n    \"message\": \"Check the submitted fields.\",\n    \"fields\": {\n      \"email\": [\"Invalid email address.\"]\n    }\n  },\n  \"request_id\": \"01JY8Z3K4M5N6P7Q8R9S0T1V2W\"\n}\n","json","",[187,199,200,209,228,243,268,289,303,330,336,342,362],{"__ignoreMap":197},[201,202,205],"span",{"class":203,"line":204},"line",1,[201,206,208],{"class":207},"sMK4o","{\n",[201,210,212,215,219,222,225],{"class":203,"line":211},2,[201,213,214],{"class":207},"  \"",[201,216,218],{"class":217},"spNyl","success",[201,220,221],{"class":207},"\"",[201,223,224],{"class":207},":",[201,226,227],{"class":207}," false,\n",[201,229,231,233,236,238,240],{"class":203,"line":230},3,[201,232,214],{"class":207},[201,234,235],{"class":217},"error",[201,237,221],{"class":207},[201,239,224],{"class":207},[201,241,242],{"class":207}," {\n",[201,244,246,249,252,254,256,259,263,265],{"class":203,"line":245},4,[201,247,248],{"class":207},"    \"",[201,250,187],{"class":251},"sBMFI",[201,253,221],{"class":207},[201,255,224],{"class":207},[201,257,258],{"class":207}," \"",[201,260,262],{"class":261},"sfazB","validation_failed",[201,264,221],{"class":207},[201,266,267],{"class":207},",\n",[201,269,271,273,276,278,280,282,285,287],{"class":203,"line":270},5,[201,272,248],{"class":207},[201,274,275],{"class":251},"message",[201,277,221],{"class":207},[201,279,224],{"class":207},[201,281,258],{"class":207},[201,283,284],{"class":261},"Check the submitted fields.",[201,286,221],{"class":207},[201,288,267],{"class":207},[201,290,292,294,297,299,301],{"class":203,"line":291},6,[201,293,248],{"class":207},[201,295,296],{"class":251},"fields",[201,298,221],{"class":207},[201,300,224],{"class":207},[201,302,242],{"class":207},[201,304,306,309,313,315,317,320,322,325,327],{"class":203,"line":305},7,[201,307,308],{"class":207},"      \"",[201,310,312],{"class":311},"sbssI","email",[201,314,221],{"class":207},[201,316,224],{"class":207},[201,318,319],{"class":207}," [",[201,321,221],{"class":207},[201,323,324],{"class":261},"Invalid email address.",[201,326,221],{"class":207},[201,328,329],{"class":207},"]\n",[201,331,333],{"class":203,"line":332},8,[201,334,335],{"class":207},"    }\n",[201,337,339],{"class":203,"line":338},9,[201,340,341],{"class":207},"  },\n",[201,343,345,347,350,352,354,356,359],{"class":203,"line":344},10,[201,346,214],{"class":207},[201,348,349],{"class":217},"request_id",[201,351,221],{"class":207},[201,353,224],{"class":207},[201,355,258],{"class":207},[201,357,358],{"class":261},"01JY8Z3K4M5N6P7Q8R9S0T1V2W",[201,360,361],{"class":207},"\"\n",[201,363,365],{"class":203,"line":364},11,[201,366,367],{"class":207},"}\n",[369,370,372],"h2",{"id":371},"client-handling","Client handling",[192,374,378],{"className":375,"code":376,"language":377,"meta":197,"style":197},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","if (response.status === 422) {\n  const body = await response.json()\n  fieldErrors.value = body.error.fields ?? {}\n  summary.value = body.error.message\n  return\n}\n","ts",[187,379,380,407,433,461,483,488],{"__ignoreMap":197},[201,381,382,386,390,393,396,399,402,405],{"class":203,"line":204},[201,383,385],{"class":384},"s7zQu","if",[201,387,389],{"class":388},"sTEyZ"," (response",[201,391,392],{"class":207},".",[201,394,395],{"class":388},"status ",[201,397,398],{"class":207},"===",[201,400,401],{"class":311}," 422",[201,403,404],{"class":388},") ",[201,406,208],{"class":207},[201,408,409,412,415,418,421,424,426,429],{"class":203,"line":211},[201,410,411],{"class":217},"  const",[201,413,414],{"class":388}," body",[201,416,417],{"class":207}," =",[201,419,420],{"class":384}," await",[201,422,423],{"class":388}," response",[201,425,392],{"class":207},[201,427,196],{"class":428},"s2Zo4",[201,430,432],{"class":431},"swJcz","()\n",[201,434,435,438,440,443,445,447,449,451,453,455,458],{"class":203,"line":230},[201,436,437],{"class":388},"  fieldErrors",[201,439,392],{"class":207},[201,441,442],{"class":388},"value",[201,444,417],{"class":207},[201,446,414],{"class":388},[201,448,392],{"class":207},[201,450,235],{"class":388},[201,452,392],{"class":207},[201,454,296],{"class":388},[201,456,457],{"class":207}," ??",[201,459,460],{"class":207}," {}\n",[201,462,463,466,468,470,472,474,476,478,480],{"class":203,"line":245},[201,464,465],{"class":388},"  summary",[201,467,392],{"class":207},[201,469,442],{"class":388},[201,471,417],{"class":207},[201,473,414],{"class":388},[201,475,392],{"class":207},[201,477,235],{"class":388},[201,479,392],{"class":207},[201,481,482],{"class":388},"message\n",[201,484,485],{"class":203,"line":270},[201,486,487],{"class":384},"  return\n",[201,489,490],{"class":203,"line":291},[201,491,367],{"class":207},[183,493,494],{},"Guidelines:",[496,497,498,502,508,514,521,524],"ul",{},[499,500,501],"li",{},"Keep the submitted values in the form.",[499,503,504,505,392],{},"Show a summary with ",[187,506,507],{},"role=\"alert\"",[499,509,510,511,392],{},"Link each error to its input with ",[187,512,513],{},"aria-describedby",[499,515,516,517,520],{},"Set ",[187,518,519],{},"aria-invalid"," on the field.",[499,522,523],{},"Move focus to the first invalid field or the error summary.",[499,525,526],{},"Do not show raw API messages for non-field errors.",[369,528,530],{"id":529},"reserved-pseudo-fields","Reserved pseudo-fields",[183,532,533,534,537,538,541,542,545],{},"Some errors are reported against internal keys such as ",[187,535,536],{},"_payload",", ",[187,539,540],{},"_fields"," or ",[187,543,544],{},"_idempotency_key",". Map these to a general form message rather than a visible input.",[369,547,549],{"id":548},"when-the-form-schema-changes","When the form schema changes",[183,551,552],{},"Required fields and allowed field names are configured on the form in Postvia. The browser cannot infer them from the public API. Submit the fields the customer website actually uses and let the API enforce the configured rules.",[554,555,556],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":197,"searchDepth":211,"depth":211,"links":558},[559,560,561],{"id":371,"depth":211,"text":372},{"id":529,"depth":211,"text":530},{"id":548,"depth":211,"text":549},"Map 422 field errors to accessible form messages without losing the user’s input.","md",{},true,{"title":89,"description":562},"xBGpLncYiHqqC6LmmoXOo-x5pT6ZUkH3Zfq-FNZzHaI",[569,571],{"title":85,"path":86,"stem":87,"description":570,"children":-1},"Render the widget, send the token and handle verification failures correctly.",{"title":93,"path":94,"stem":95,"description":572,"children":-1},"Distinguish durable acceptance from email delivery and reset the form safely.",1795377933230]