API Reference

Submit a form

Request

Accepts two content types:

• application/x-www-form-urlencoded — standard HTML form submission.
• application/json — JSON body with key-value pairs.

Example (JSON)

curl -X POST https://api.simplyforms.dev/v1/forms/YOUR_FORM_ID/submissions \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Doe",
    "email": "jane@example.com",
    "message": "Hello from the API!"
  }'

Example (fetch)

const response = await fetch(
  "https://api.simplyforms.dev/v1/forms/YOUR_FORM_ID/submissions",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      name: "Jane Doe",
      email: "jane@example.com",
      message: "Hello from the API!",
    }),
  }
);

const result = await response.json();
console.log(result); // { success: true, message: "Submitted successfully" }

Response

Success (201)

{ "success": true, "message": "Submitted successfully" }

If the form has a redirect URL, the response also includes it as redirectUrl, so your script can send the visitor there.

Plain HTML forms (no JavaScript)

When a browser submits a plain <form method="POST"> straight to this endpoint, the response is a 303 redirect instead of JSON: to the form's redirect URL if it has one, otherwise to a SimplyForms confirmation page. If the submission is rejected, the browser goes to a SimplyForms error page instead of receiving the JSON errors below. Requests from fetch(), XHR and servers always get JSON.

Errors

Special Fields