Getting Started

Quick Start Guide

Get form submissions delivered to your inbox in under 2 minutes.

Create a Form

After signing up, create a new workspace and add a form. You'll get a unique endpoint URL:

Endpoint URL

https://yoursite.com/f/YOUR_FORM_ID

Point Your Form

Set your HTML form's action attribute to your townhall endpoint:

HTML

<form action="https://yoursite.com/f/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"></textarea>
  <button type="submit">Send</button>
</form>

You're Done!

That's it! Submissions will now be:

📥

Stored

Securely saved in your dashboard

📧

Emailed

Sent to your notification addresses

↩️

Auto-replied

Confirmation sent to submitter

Flexible Field Detection

townhall accepts any field names you want. For auto-reply emails, we automatically detect email addresses from any field.

💡

Auto-Reply

We scan all fields for valid email addresses. Common names like email, userEmail, contact_email are checked first, but any field containing a valid email will work.

✨

Personalization

Use {name} in your auto-reply message. We'll find the name from fields like name, fullName, firstName, etc.