Getting Started

Quick Start Guide

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

1

Create a Form

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

Endpoint URL
https://townhall.gg/f/YOUR_FORM_ID
2

Point Your Form

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

HTML
<form action="https://townhall.gg/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>
3

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.

Next Steps

Configure webhooks to send data to Slack, Discord, or custom endpoints
Customize auto-reply messages with your branding
Set up email notifications to multiple team members
Export submissions as CSV for reporting