API Reference & Configuration
Submit a Form
Send data to a form endpoint. This is identical to a standard HTML form POST.
POST https://formboost.app/f/:endpoint_id
JSON submission
1const response = await fetch("https://formboost.app/f/YOUR_ENDPOINT_ID", {
2 method: "POST",
3 headers: { "Content-Type": "application/json" },
4 body: JSON.stringify({
5 email: "[email protected]",
6 message: "Hello from the API"
7 })
8});
9
10const result = await response.json();cURL example
1curl -X POST https://formboost.app/f/YOUR_ENDPOINT_ID \
2 -H "Content-Type: application/json" \
3 -d '{"email": "[email protected]", "message": "Hello"}'Response
1{
2 "success": true,
3 "id": "sub_abc123",
4 "message": "Submission received"
5}Error Codes
| Code | Meaning |
|---|---|
400 | Bad request — missing required fields |
404 | Endpoint not found |
429 | Rate limited — slow down requests |
500 | Internal server error |
Special Fields
These hidden fields control Formboost behavior without being stored as submission data:
| Field | Description |
|---|---|
_redirect | URL to redirect to after submission |
_subject | Custom email subject line |
_replyto | Set reply-to address on notification emails |
_honey | Honeypot field name for spam detection |
Email Notifications
By default, Formboost sends an email notification to your account email for every submission. You can customize this under Endpoint → Notifications.
| Setting | Description |
|---|---|
| To address | Where notification emails are sent |
| Subject | Customize with _subject field |
| Reply-to | Auto-populated from the _replyto field |
Spam Protection
Formboost uses AI-powered spam filtering. Configure sensitivity under Endpoint → Spam Protection.
Honeypot Fields
Add a hidden input that humans never fill in. Bots usually do.
1<form action="https://formboost.app/f/YOUR_ENDPOINT_ID" method="POST">
2 <!-- Honeypot: hidden from real users -->
3 <input type="text" name="_honey" style="display:none" tabindex="-1" autocomplete="off" />
4
5 <input type="email" name="email" required />
6 <button type="submit">Submit</button>
7</form>Set _honey as the honeypot field name in your endpoint settings to activate detection.