Create your first form

Configure recipients, Turnstile, a success URL and the public endpoint.

A form is the public endpoint. It inherits settings from the system, customer and website, so you only set the values this form needs.

Create the form

  1. Open Forms and choose New form.
  2. Select the website.
  3. Name the form, for example Contact form.
  4. Configure at least one recipient. Recipients are server-controlled; visitors cannot supply them.
  5. Choose whether Turnstile is enabled.
  6. Optionally add a success URL. It must be HTTPS and on an allowed website origin.
  7. Save.

The form becomes active when the readiness checklist passes:

  • The customer, website and form are active.
  • At least one allowed origin exists.
  • At least one recipient exists.
  • A Turnstile widget is configured if Turnstile is enabled.

Copy the endpoint

The primary endpoint is:

POST https://api.postvia.dev/v1/forms/{public_id}/submissions

The short alias is:

POST https://api.postvia.dev/f/{public_id}

Both share the same implementation and response contract. Use the versioned endpoint for new integrations.

The public ID is generated by Postvia. Rotating it immediately breaks every existing integration.

Next

Continue to Submit your first JSON request.