Getting Started

Welcome to FiraForm! This guide will help you get started with the headless form backend that handles submissions, spam protection, file uploads, and integrations.

What is FiraForm?

FiraForm is a headless form backend service that eliminates the need to build your own server infrastructure for handling form submissions. Simply point your HTML forms to FiraForm’s API endpoint and start collecting submissions instantly.

Key Features:

• No Backend Required - Submit forms from static sites, JAMstack apps, or any website
• Spam Protection - AI-powered spam detection and CAPTCHA support
• File Uploads - Handle file attachments without storage headaches
• Validation - Configure field rules and validation on the server side
• Team Collaboration - Share forms with teammates and control access
• Webhooks - Send submissions to your own systems in real-time
• Email Notifications - Get notified when forms are submitted

Quick Start

1. Sign up for an account at https://a.firaform.com
2. Create your first form - Every new account starts with “My First Form”
3. Copy your form endpoint - Click the copy button next to your form
4. Add to your website - Use the endpoint in your HTML form’s action attribute

Basic Example

<form action="https://a.firaform.com/api/f/YOUR-FORM-ID" method="POST">
  <label for="email">Email</label>
  <input type="email" name="email" id="email" required />
  
  <label for="message">Message</label>
  <textarea name="message" id="message" required></textarea>
  
  <button type="submit">Submit</button>
</form>

Replace YOUR-FORM-ID with the actual form ID from your dashboard.

Initial Setup Steps

1. Configure Allowed Domains

FiraForm uses domain whitelisting for security. By default, new accounts have * (all domains) allowed.

• Go to Domains page
• Add your website domain (e.g., example.com)
• Or keep * to allow submissions from any domain

Learn more about Domain Whitelisting

2. Configure Field Validation

Define validation rules for your form fields:

• Go to Fields page for your form
• Fields are auto-detected when first submission arrives
• Or manually add fields before receiving submissions
• Set required status, data types, and validation rules

Learn more about Field Configuration

3. Set Up Success & Error Redirects

Control where users go after submitting:

• Go to Settings page for your form
• Add Success Redirect URL for successful submissions
• Add Error Redirect URL for validation failures
• Leave empty to use FiraForm’s default pages

Learn more about Form Settings

4. Enable Email Notifications

Get notified when submissions arrive:

• Go to Settings page
• Add email addresses (must be team members)
• Configure whether to attach uploaded files

Learn more about Email Notifications

Ajax / JavaScript Submissions

For single-page applications or custom handling, submit via JavaScript:

fetch('https://a.firaform.com/api/f/YOUR-FORM-ID', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'user@example.com',
    message: 'Hello from JavaScript!'
  })
})
  .then(response => response.json())
  .then(data => {
    console.log('Success:', data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

Add the Accept: application/json header to receive JSON responses instead of redirects.

Learn more in the Quick Start Guide

Understanding Form Flow

1. User submits form on your website
2. FiraForm validates the submission against your field rules
3. Spam detection analyzes the submission using AI
4. Success: User is redirected to success page, you get notified
5. Failure: User is redirected to error page with validation details

Common Use Cases

Contact Form

• Simple name, email, message fields
• Email notifications to support team
• Success redirect to thank-you page

Newsletter Signup

• Single email field
• Webhook to marketing automation
• CSV export for import to email service

Job Applications

• Multiple text fields, file uploads (resume)
• Email notifications with attachments
• Export to CSV for review

Support Tickets

• Text fields, dropdown selections
• Webhook to ticket system
• Spam protection with CAPTCHA

Next Steps

Now that you understand the basics:

• Quick Start - Follow step-by-step setup instructions
• Field Validation - Configure validation rules
• Spam Protection - Enable CAPTCHA and honeypots
• Webhooks - Send data to your systems
• Team Collaboration - Add teammates and manage access
• API Reference - Technical documentation

Need Help?

• Review the Documentation Home for all topics
• Check the Quick Start for common setup issues
• Explore Form Settings for configuration options