Frequently asked questions

Common questions about Postvia, the public API and delivery.

Is Postvia a public SaaS?

No. Postvia is a private, operator-managed service for managed customer websites. There is no public signup, customer login, billing or pricing.

Do I need a backend?

No. A static HTML form or a browser JavaScript request can submit directly to Postvia. A backend is useful for custom validation, but it is not required.

Is the public ID a secret?

No. It identifies a form. Do not treat it as authentication. Origin allowlists, Turnstile and rate limits protect the endpoint.

Does a 201 mean the email was delivered?

No. It means the submission is durably stored and scheduled. Email delivery is asynchronous and at-least-once. Check the delivery status in the administration portal.

Why does cURL fail with 403?

Send an allowed Origin header. Server-side clients must supply the customer website origin explicitly.

Can I use the short /f/{public_id} endpoint?

Yes. It is a supported alias with the same implementation and response contract. Use the versioned endpoint in new integrations.

Can visitors choose recipients or redirect URLs?

No. Recipients, subjects, sender identity and redirect destinations are server-controlled.

Why was my idempotency request rejected with 409?

The same key was previously accepted with a different payload. Use a new key for changed content.

How long are idempotency keys retained?

For the form’s retention period: default 90 days, maximum 365 days. The retention purge removes them.

Does Postvia support file uploads?

No. Files, nested objects and arbitrary binary content are rejected.

Can I use Postvia for a full finance application?

The MVP is intended for ordinary enquiries. Do not collect identity documents, credentials, payment card details or full finance applications without a separate security and privacy review.

Where do I report a delivery problem?

Open the submission in the administration portal, inspect the delivery timeline, then see Troubleshooting delivery.