[{"data":1,"prerenderedAt":504},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Ffirst-json-request":176,"\u002Fgetting-started\u002Ffirst-json-request-surround":499},[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":24,"apiOperation":178,"body":179,"description":493,"extension":494,"links":178,"meta":495,"navigation":496,"path":25,"related":178,"seo":497,"stem":26,"__hash__":498},"docs\u002F1.getting-started\u002F5.first-json-request.md",null,{"type":180,"value":181,"toc":487},"minimark",[182,195,329,334,408,415,419,438,445,451,455,465,469,483],[183,184,185,186,190,191,194],"p",{},"This is the smallest useful request. Replace ",[187,188,189],"code",{},"abc123"," with the form’s public ID and ",[187,192,193],{},"https:\u002F\u002Fcustomer-site.example"," with an origin configured on the website.",[196,197,202],"pre",{"className":198,"code":199,"language":200,"meta":201,"style":201},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST 'https:\u002F\u002Fapi.postvia.dev\u002Fv1\u002Fforms\u002Fabc123\u002Fsubmissions' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Accept: application\u002Fjson' \\\n  -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \\\n  -H 'Origin: https:\u002F\u002Fcustomer-site.example' \\\n  --data-raw '{\n    \"name\": \"John Smith\",\n    \"email\": \"john@example.com\",\n    \"message\": \"I would like more information\"\n  }'\n","bash","",[187,203,204,234,249,263,277,291,302,308,314,320],{"__ignoreMap":201},[205,206,209,213,217,220,224,227,230],"span",{"class":207,"line":208},"line",1,[205,210,212],{"class":211},"sBMFI","curl",[205,214,216],{"class":215},"sfazB"," -X",[205,218,219],{"class":215}," POST",[205,221,223],{"class":222},"sMK4o"," '",[205,225,226],{"class":215},"https:\u002F\u002Fapi.postvia.dev\u002Fv1\u002Fforms\u002Fabc123\u002Fsubmissions",[205,228,229],{"class":222},"'",[205,231,233],{"class":232},"sTEyZ"," \\\n",[205,235,237,240,242,245,247],{"class":207,"line":236},2,[205,238,239],{"class":215},"  -H",[205,241,223],{"class":222},[205,243,244],{"class":215},"Content-Type: application\u002Fjson",[205,246,229],{"class":222},[205,248,233],{"class":232},[205,250,252,254,256,259,261],{"class":207,"line":251},3,[205,253,239],{"class":215},[205,255,223],{"class":222},[205,257,258],{"class":215},"Accept: application\u002Fjson",[205,260,229],{"class":222},[205,262,233],{"class":232},[205,264,266,268,270,273,275],{"class":207,"line":265},4,[205,267,239],{"class":215},[205,269,223],{"class":222},[205,271,272],{"class":215},"Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000",[205,274,229],{"class":222},[205,276,233],{"class":232},[205,278,280,282,284,287,289],{"class":207,"line":279},5,[205,281,239],{"class":215},[205,283,223],{"class":222},[205,285,286],{"class":215},"Origin: https:\u002F\u002Fcustomer-site.example",[205,288,229],{"class":222},[205,290,233],{"class":232},[205,292,294,297,299],{"class":207,"line":293},6,[205,295,296],{"class":215},"  --data-raw",[205,298,223],{"class":222},[205,300,301],{"class":215},"{\n",[205,303,305],{"class":207,"line":304},7,[205,306,307],{"class":215},"    \"name\": \"John Smith\",\n",[205,309,311],{"class":207,"line":310},8,[205,312,313],{"class":215},"    \"email\": \"john@example.com\",\n",[205,315,317],{"class":207,"line":316},9,[205,318,319],{"class":215},"    \"message\": \"I would like more information\"\n",[205,321,323,326],{"class":207,"line":322},10,[205,324,325],{"class":215},"  }",[205,327,328],{"class":222},"'\n",[330,331,333],"h2",{"id":332},"success","Success",[196,335,339],{"className":336,"code":337,"language":338,"meta":201,"style":201},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"success\": true,\n  \"submission_id\": \"8f2c1e7a4b6d8c0e5f3a2b1c9d8e7f60\",\n  \"message\": \"Your enquiry has been received.\"\n}\n","json",[187,340,341,345,362,384,403],{"__ignoreMap":201},[205,342,343],{"class":207,"line":208},[205,344,301],{"class":222},[205,346,347,350,353,356,359],{"class":207,"line":236},[205,348,349],{"class":222},"  \"",[205,351,332],{"class":352},"spNyl",[205,354,355],{"class":222},"\"",[205,357,358],{"class":222},":",[205,360,361],{"class":222}," true,\n",[205,363,364,366,369,371,373,376,379,381],{"class":207,"line":251},[205,365,349],{"class":222},[205,367,368],{"class":352},"submission_id",[205,370,355],{"class":222},[205,372,358],{"class":222},[205,374,375],{"class":222}," \"",[205,377,378],{"class":215},"8f2c1e7a4b6d8c0e5f3a2b1c9d8e7f60",[205,380,355],{"class":222},[205,382,383],{"class":222},",\n",[205,385,386,388,391,393,395,397,400],{"class":207,"line":265},[205,387,349],{"class":222},[205,389,390],{"class":352},"message",[205,392,355],{"class":222},[205,394,358],{"class":222},[205,396,375],{"class":222},[205,398,399],{"class":215},"Your enquiry has been received.",[205,401,402],{"class":222},"\"\n",[205,404,405],{"class":207,"line":279},[205,406,407],{"class":222},"}\n",[183,409,410,411,414],{},"HTTP ",[187,412,413],{},"201"," means the submission is durably stored and scheduled. It does not mean the email has been delivered.",[330,416,418],{"id":417},"retry-safely","Retry safely",[183,420,421,422,426,427,430,431,434,435,437],{},"Reuse the ",[423,424,425],"strong",{},"same"," ",[187,428,429],{},"Idempotency-Key"," if the request fails before you receive a response. An identical replay returns ",[187,432,433],{},"200"," with the same ",[187,436,368],{}," and creates no duplicate delivery.",[183,439,440,441,444],{},"If the payload changes, use a new key. Reusing the key with different content returns ",[187,442,443],{},"409 idempotency_conflict",".",[446,447,448],"tip",{},[183,449,450],{},"Generate a UUID per logical submission, not per HTTP attempt. Rotate the key after success or when the user changes the data.",[330,452,454],{"id":453},"native-html-forms","Native HTML forms",[183,456,457,458,461,462,444],{},"A native HTML form posts to the same endpoint and receives a ",[187,459,460],{},"303"," redirect instead of JSON. See ",[463,464,81],"a",{"href":82},[330,466,468],{"id":467},"next","Next",[470,471,472,478],"ul",{},[473,474,475],"li",{},[463,476,477],{"href":29},"Configure email notifications",[473,479,480],{},[463,481,482],{"href":90},"Handling validation errors",[484,485,486],"style",{},"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 .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":201,"searchDepth":236,"depth":236,"links":488},[489,490,491,492],{"id":332,"depth":236,"text":333},{"id":417,"depth":236,"text":418},{"id":453,"depth":236,"text":454},{"id":467,"depth":236,"text":468},"Send a JSON submission with a stable idempotency key and an allowed origin.","md",{},true,{"title":24,"description":493},"S8luVR02Ya7i2ZcngM0kBxU2dmQiiiQXXZ4XOOhipc4",[500,502],{"title":20,"path":21,"stem":22,"description":501,"children":-1},"Configure recipients, Turnstile, a success URL and the public endpoint.",{"title":28,"path":29,"stem":30,"description":503,"children":-1},"Set recipients, subject, Reply-To and delivery expectations.",1795377932597]