API Reference & Configuration

Submit a Form

Send data to a form endpoint. This is identical to a standard HTML form POST.

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

Special Fields

These hidden fields control Formboost behavior without being stored as submission data:

Email Notifications

By default, Formboost sends an email notification to your account email for every submission. You can customize this under Endpoint → Notifications.

Custom Subject

Use double curly braces to include submission data in the subject line:

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.

Allowed Origins

Restrict which domains can submit to your endpoint:

Leave blank to allow all origins. This prevents other sites from abusing your endpoint.

Data Retention

You can export all submissions as CSV at any time from the dashboard regardless of plan.