Guides
Documentation
Set up Formsig once, then drop a normal HTML form on any site. This page walks you through creating a form, wiring your HTML, optional email and webhooks, Hosted Pages (/p/), and plan limits, for a fuller product rundown see Features.
Quick start (2 minutes)
- Create a form in the dashboard and copy its endpoint (
/f/{form_id}). - Set your HTML form
methodtopostandactionto that full URL. - Submit once and confirm the entry appears in Submissions.
Copy/paste starter:
<form action="https://formsig.com/f/{form_id}" method="post">
<input name="email" type="email" required />
<textarea name="message"></textarea>
<button type="submit">Send</button>
</form>Want to test first? Open the Playground and submit a sample demo with your endpoint.
Overview
New here? You need a Formsig account and one form in the dashboard. Each form gets its own POST URL. Your page submits to that URL; we store the submission and can email you or call a webhook you configure.
No JavaScript is required for a basic setup: plain <form method="post"> with named fields is enough. File fields work when you use multipart/form-data on the form.
Create a form
- Sign in and open Forms in the dashboard.
- Create a form and note the form ID (you will see it in the UI).
- Your endpoint path is
/f/<your-form-id>. The full URL is your Formsig host plus that path, for examplehttps://your-domain.com/f/a1b2c3d4.
Keep the ID private the same way you would an API key: anyone who can POST to it can create submissions.
Connect your HTML form
Point the browser at your endpoint: set method="POST" and action to your full Formsig URL. Add a name on every field you want stored (for example email, message).
For uploads (resumes, attachments, portfolios), set enctype="multipart/form-data" on the <form> and use <input type="file"> fields as needed.
Submissions and email
Every successful POST is saved to your account. Open Submissions on the form to read, search, and export.
Under Account, add and verify the addresses that may receive mail. On each form’s Settings tab, choose notification behavior: instant, off, or digest, depending on what your account supports.
Webhooks
What they do. After a submission is stored, Formsig can send an HTTP POST with JSON to a URL you provide. Useful for Zapier, Make, your own API, or internal tools, no polling from the browser.
Setup. In the dashboard, open the form → Settings → Submission webhook. Enter an https:// URL reachable from the public internet (localhost URLs are not accepted). Save.
Signing. Optionally set a signing secret. Your endpoint can verify deliveries using the X-Formsig-Signature header (HMAC-SHA256 over the timestamp and raw JSON body). When editing, leave the secret field blank to keep the existing key.
Payload. Requests use Content-Type: application/json. The body includes version, event (for example submission.created), webhook_id, form_id, submission_id, created_at, and data (field values as stored; files appear as metadata, not raw bytes).
Reliability. The visitor’s submit response is not blocked on your webhook. Delivery runs in the background with a timeout and one automatic retry on common transient failures. Return 2xx when you accept the payload.
Email notifications are separate; you can use webhooks even when email is off or on digest.
Verification examples. Verify signatures in your webhook receiver (Node, Python, etc.) before processing. Keep handlers idempotent using submission_id or webhook_id.
AI Chat (Beta)
AI Chat adds a chat bubble (chat widget) to your own website or to a Formsig Hosted Page. Visitors ask questions; answers come from pages crawled from your assistant Site URL plus custom knowledge (AI training notes) you add in the dashboard. Each AI reply counts toward your plan quota (Free includes a one-time trial; paid tiers reset monthly — see Pricing).
Quick terms: AI Chat = the product. Assistant = your bot. Custom knowledge = AI training notes that extend the site crawl. Chat widget = the bubble visitors see.
Dashboard → AI Chat → name your assistant and set your site URL.
Add AI training notes for policies, pricing, or FAQs the crawl may miss.
Paste one script tag on your site, or pick an assistant on a Hosted Page.
Chat bubble on your site
Site crawl + your custom knowledge
Get a reply by email → your Leads inbox
On your own website
Add one script tag before </body> on any page (or in your site template). The assistant ID comes from Dashboard → Chat:
<script src="https://formsig.com/c/{assistant_id}/widget.js" async defer></script>- Create an assistant in Dashboard → Chat (AI Chat).
- Set Site URL to the website you want answers to reflect (your marketing site or docs — not the widget script URL).
- Run Crawl site and add custom knowledge for FAQs, policies, or pricing the crawl may miss.
- Copy the embed script from the assistant page: one line loads /c/{assistant_id}/widget.js.
- Paste the script before