Quickstart

This guide will get you set up with Formoar and collecting form submissions in under 60 seconds. We'll walk through creating your first form endpoint and connecting it to an HTML form.

Create a form endpoint

1. Log in to your Formoar dashboard
2. Click "New Form" and give it a name (e.g., "Contact Form")
3. Copy the endpoint URL — it looks like https://formoar.com/api/f/your-form-id

Add the form to your site

Point your HTML form's action attribute at your Formoar endpoint. That's it — no JavaScript required.

<form action="https://formoar.com/api/f/your-form-id" method="POST">
  <label for="name">Name</label>
  <input type="text" id="name" name="name" required />

  <label for="email">Email</label>
  <input type="email" id="email" name="email" required />

  <label for="message">Message</label>
  <textarea id="message" name="message" required></textarea>

  <button type="submit">Send</button>
</form>

Handle submissions with AJAX

If you prefer to handle submissions without a page redirect, use fetch to submit the form as JSON:

const form = document.querySelector('form')

form.addEventListener('submit', async (e) => {
  e.preventDefault()
  const data = Object.fromEntries(new FormData(form))

  const response = await fetch('https://formoar.com/api/f/your-form-id', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data),
  })

  const result = await response.json()
  if (result.ok) {
    alert('Thank you for your submission!')
  }
})

Custom redirect

On paid plans, you can set a custom redirect URL in your form settings. After a successful HTML form submission, the user will be redirected to your chosen URL instead of the default Formoar thank-you page.

What's next?

Great, you're now collecting form submissions! Here are some next steps:

• Configure allowed origins to restrict which domains can submit to your form
• Set up spam protection with honeypot fields and Cloudflare Turnstile
• Understand error codes that the API may return