Forms · Customer documentation

What you prepare

A webpage with input fields. No submission server or separate account is needed; you build the HTML form itself.

Steps in the workspace

1. 01Create a form in PicoSvc and copy its submission URL.
2. 02Set it as action with method=POST on your HTML form.
3. 03Send a test submission and inspect the list.

Example request / integration

Point a shop contact form (name, email, message) to the issued URL; inspect submissions in PicoSvc and optionally export CSV.

<form action="https://YOUR_ISSUED_ENDPOINT/forms/PUBLIC_ID" method="POST">
  <label>Name <input name="name" required></label>
  <label>Email <input name="email" type="email" required></label>
  <label>Message <textarea name="message" required></textarea></label>
  <button type="submit">Send</button>
</form>
<!-- Replace action with the exact endpoint returned by PicoSvc. -->

Examples use placeholders: replace $BASE_URL, $SESSION_TOKEN and issued URLs with real values. Never publish session tokens or API keys in a webpage or repository.

A plain HTML form normally displays the JSON 202 response. To send visitors to a thank-you page, configure successRedirect using the form configuration API. Multipart file uploads are unsupported.

Management API entry point

POST /api/picosvc/forms

Create a form name and set the issued URL as your existing HTML form action. Submit JSON or URL-encoded fields.

Submission URL, saved responses (name/email/message etc.), and optional webhook delivery.

What it does not do

Does not generate form UI, accept multipart file uploads, or automatically email submission notifications.

Feature comparison and sources

Form endpoint and submission handling：Issue an HTML form endpoint with submission history, CSV, and optional webhook.

Formspree：Documents APIs to retrieve form submissions.