Getting Started
Headless Forms is a backend-only form submission service. You create forms, get a unique API endpoint, and POST data to it from any frontend — static sites, React, Vue, Next.js, mobile apps, or plain HTML forms.
How It Works
- Create an account and log in to the dashboard.
- Create a form — give it a name, define your fields, and configure security settings.
- Copy the endpoint — every form gets a unique URL like
/api/v1/form/01JCK.... - Submit data from your frontend using a standard POST request.
- View submissions in the dashboard and receive notifications via email, webhooks, or Telegram.
Quick Example
Submit a contact form using fetch:
const response = await fetch('https://headless-form.robertboes.nl/api/v1/form/01JCK...', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
name: 'Alex',
email: 'alex@example.com',
message: 'Hello from my website!',
}),
});
const data = await response.json();
console.log(data.message); // "Form submitted successfully."
Or with a plain HTML form:
<form action="https://headless-form.robertboes.nl/api/v1/form/01JCK..." method="POST">
<input type="text" name="name" required />
<input type="email" name="email" required />
<textarea name="message"></textarea>
<button type="submit">Send</button>
</form>
What's Included
- 8 field types with automatic validation and type coercion
- Multi-layer security — CORS origins, honeypot, bot protection (Turnstile/reCAPTCHA), rate limiting
- Multi-channel notifications — email, webhooks, Telegram
- Non-guessable endpoints — every form gets a unique, random URL
Next Steps
- Field Schema — Learn about the 8 field types and how validation works.
- Security Layers — Understand the multi-layer protection model.
- API Reference — Full details on the submit endpoint.