Documentation
Get your form endpoint and start receiving submissions in minutes.
Quick start
Sign up to get your form endpoint. You can submit data with a simple POST to that URL, or use the generated form HTML.
Your endpoint
Each form has an endpoint like https://yoursite.com/f/abc123. Send application/x-www-form-urlencoded or multipart/form-data (for file uploads on Starter and Pro). No API keys in the request; the endpoint URL is the identifier.
Form HTML
Point your form action to your endpoint and set method="POST". Use name attributes on inputs; those names become the keys in the submission payload. You can use our hosted form page with ?template=contact or waitlist.
Validation
We accept whatever field names and values you send in the submission. Validate required fields, format, and length in your own form or app before posting to the endpoint.
Webhooks (Starter & Pro)
On Starter and Pro you can set a webhook URL per form; we send a POST with the submission payload when a submission is received. Use it to forward to Slack, Discord, Zapier, or your own endpoint. Validate requests using the signature header we provide.
Recipients can stop webhook deliveries via the link we send in each payload (_boringform_cancel_url). If someone receives requests they didn't ask for, they can open that URL once and we stop sending to that destination.
Export & data download
Account export (all plans): In the dashboard, go to Settings and use “Account export” to download your full data (profile, forms, submissions) as JSON. This is available to everyone and supports GDPR data portability.
Submission exports (Starter & Pro): CSV, JSON, and Excel exports of submissions are available on Starter (up to 500 rows per export) and Pro (up to 2000 rows per export). Use “Export selected” or “Export by date range” in the Submissions section of the dashboard.
Billing & limits
All plans include unlimited notifications (emails and webhooks). A notification is any message we send on your behalf: each email to a recipient and each webhook call (including retries) counts as one. When demand is low we send one email per submission; when demand is higher we batch multiple submissions into a single digest email.
Plan differences: submissions (Free: 100/month, paid: unlimited), forms (Free: 5, Starter: 10, Pro: unlimited), history (Free: 30 days, paid: unlimited), attachments (Free: none, paid: file attachments), and AI Insights (Pro only).
Need help?
Starter and Pro users have an in-app support thread in the dashboard. For general inquiries or if you’re on Hobby, email support@boringform.com or hello@boringform.com.