[{"data":1,"prerenderedAt":322},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Ffirst-form":176,"\u002Fgetting-started\u002Ffirst-form-surround":317},[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":20,"apiOperation":178,"body":179,"description":311,"extension":312,"links":178,"meta":313,"navigation":314,"path":21,"related":178,"seo":315,"stem":22,"__hash__":316},"docs\u002F1.getting-started\u002F4.first-form.md",null,{"type":180,"value":181,"toc":305},"minimark",[182,186,191,229,232,247,251,254,270,273,282,285,291,295,301],[183,184,185],"p",{},"A form is the public endpoint. It inherits settings from the system, customer and website, so you only set the values this form needs.",[187,188,190],"h2",{"id":189},"create-the-form","Create the form",[192,193,194,207,210,217,220,223,226],"ol",{},[195,196,197,198,202,203,206],"li",{},"Open ",[199,200,201],"strong",{},"Forms"," and choose ",[199,204,205],{},"New form",".",[195,208,209],{},"Select the website.",[195,211,212,213,206],{},"Name the form, for example ",[214,215,216],"code",{},"Contact form",[195,218,219],{},"Configure at least one recipient. Recipients are server-controlled; visitors cannot supply them.",[195,221,222],{},"Choose whether Turnstile is enabled.",[195,224,225],{},"Optionally add a success URL. It must be HTTPS and on an allowed website origin.",[195,227,228],{},"Save.",[183,230,231],{},"The form becomes active when the readiness checklist passes:",[233,234,235,238,241,244],"ul",{},[195,236,237],{},"The customer, website and form are active.",[195,239,240],{},"At least one allowed origin exists.",[195,242,243],{},"At least one recipient exists.",[195,245,246],{},"A Turnstile widget is configured if Turnstile is enabled.",[187,248,250],{"id":249},"copy-the-endpoint","Copy the endpoint",[183,252,253],{},"The primary endpoint is:",[255,256,261],"pre",{"className":257,"code":258,"language":259,"meta":260,"style":260},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","POST https:\u002F\u002Fapi.postvia.dev\u002Fv1\u002Fforms\u002F{public_id}\u002Fsubmissions\n","http","",[214,262,263],{"__ignoreMap":260},[264,265,268],"span",{"class":266,"line":267},"line",1,[264,269,258],{},[183,271,272],{},"The short alias is:",[255,274,276],{"className":257,"code":275,"language":259,"meta":260,"style":260},"POST https:\u002F\u002Fapi.postvia.dev\u002Ff\u002F{public_id}\n",[214,277,278],{"__ignoreMap":260},[264,279,280],{"class":266,"line":267},[264,281,275],{},[183,283,284],{},"Both share the same implementation and response contract. Use the versioned endpoint for new integrations.",[286,287,288],"note",{},[183,289,290],{},"The public ID is generated by Postvia. Rotating it immediately breaks every existing integration.",[187,292,294],{"id":293},"next","Next",[183,296,297,298,206],{},"Continue to ",[299,300,24],"a",{"href":25},[302,303,304],"style",{},"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":260,"searchDepth":306,"depth":306,"links":307},2,[308,309,310],{"id":189,"depth":306,"text":190},{"id":249,"depth":306,"text":250},{"id":293,"depth":306,"text":294},"Configure recipients, Turnstile, a success URL and the public endpoint.","md",{},true,{"title":20,"description":311},"jYSQotLVhfvbXKEiwrewfTmUu-sxpPM2_OS_0Wts2a8",[318,320],{"title":16,"path":17,"stem":18,"description":319,"children":-1},"Provision the customer, website and allowed origin in the Postvia administration portal.",{"title":24,"path":25,"stem":26,"description":321,"children":-1},"Send a JSON submission with a stable idempotency key and an allowed origin.",1795377932597]