saveform Logosaveform

Documentation

Quick Start

Get started with SaveForm.io in three simple steps:

  1. Sign up - Create a free account at SaveForm.io
  2. Create a form - Get your unique form ID from the dashboard
  3. Point your form - Update your form's action attribute

HTML Form Integration

The simplest way to integrate SaveForm.io is by pointing your HTML form's action attribute to your unique endpoint:

contact-form.html
<form action="https://saveform.io/api/submit/YOUR_FORM_ID"
method="POST">
<input type="text" name="name" placeholder="Your name" required />
<input type="email" name="email" placeholder="Your email" required />
<textarea name="message" placeholder="Your message" required></textarea>
<button type="submit">Send Message</button>
</form>

Replace YOUR_FORM_ID with your actual form ID from the dashboard.

JavaScript Integration

For more control, use JavaScript with the Fetch API:

submit-form.js
const formData = {
name: 'John Doe',
email: 'john@example.com',
message: 'Hello!'
};
fetch('https://saveform.io/api/submit/YOUR_FORM_ID', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(formData)
}
.then(response => response.json())
.then(data => {
console.log('Success:', data);
})
.catch(error => {
console.error('Error:', error);
});

Spam Protection

Add a honeypot field to your form to filter out spam bots automatically:

spam-protected.html
<form action="https://saveform.io/api/submit/YOUR_FORM_ID" method="POST">
<!-- Honeypot field - hidden from users but visible to bots -->
<input type="text" name="_honey" style="display:none" />
<!-- Your regular form fields -->
<input type="text" name="name" required />
<input type="email" name="email" required />
<button type="submit">Submit</button>
</form>

Submissions with the _honey field filled will be marked as spam in your dashboard.

Custom Redirects

Redirect users to a custom thank you page after submission. By default, users will see a success page before redirecting. You can control this behavior with the _redirect_mode parameter.

Redirect Modes:

  • success (default): Shows a success page with a 5-second countdown before redirecting. Users can click "Go back now" to redirect immediately.
  • direct: Instantly redirects users to your thank you page without showing the success page.
redirect-form.html
<form action="https://saveform.io/api/submit/YOUR_FORM_ID" method="POST">
<!-- Default: shows success page before redirecting -->
<input type="hidden" name="_redirect" value="https://yoursite.com/thank-you" />
<!-- For instant redirect, add: -->
<input type="hidden" name="_redirect_mode" value="direct" />
<!-- Your form fields -->
<input type="text" name="name" required />
<button type="submit">Submit</button>
</form>

Response Format

When submitting via JavaScript/JSON, you'll receive a JSON response:

response.json
// Success response
{
"success": true,
"message": "Submission received successfully"
}
// Error response
{
"error": "Submission limit reached",
"message": "Your monthly submission limit has been reached."
}

Rate Limits

Each plan has a monthly submission limit. When you reach your limit, new submissions will return a 429 error until the next billing period or you upgrade your plan.

Note: Spam submissions (caught by the honeypot field) don't count toward your limit.

Forms

Each form you create gets a unique endpoint for collecting submissions.

You can organize forms however makes sense for you:

  • One form per contact page (e.g., Contact Form, Support Form, Sales Inquiry)
  • One form per website section (e.g., Newsletter Signup, Feedback Form)
  • Multiple forms across different sites or domains

Higher tier plans allow more forms, with Pro offering unlimited forms.

Data Retention

Data retention determines how long we store your submissions:

  • Free plan: 30 days
  • Lite plan: 90 days
  • Pro plan: Unlimited (your data is never deleted)

After the retention period, submissions are automatically deleted to comply with your plan limits.

Exporting Data

Export your submissions in CSV or JSON format directly from the dashboard:

  1. Navigate to your form's submissions page
  2. Click the "Export" button in the top right
  3. Choose CSV or JSON format
  4. Your file will download automatically

Note: Data export is available on Lite and Pro plans.

Pricing

Choose a plan that fits your needs. All plans include spam protection, dashboard access, and instant setup.

Need Help?

Can't find what you're looking for? Send us a message and we'll get back to you as soon as possible.

Powered by SaveForm.io
Documentation - SaveForm.io | Form Backend Integration Guide | SaveForm.io