SingleForm Developer Documentation
SingleForm is a form builder with a mobile-first submission experience. When users submit forms through the SingleForm mobile app, the data is sent directly to your server via a signed webhook — giving you full control over how submissions are processed. We never store your submission data — it goes straight from the user’s phone to your server.
Try It Out
See SingleForm in action with these live examples. Scan the QR code with the SingleForm mobile app, or tap the button on mobile.
Webhook Form
Send form submissions directly to your server. Perfect for contact forms, lead generation, and custom integrations.
Autofill Form
Fill form fields in real-time as users type on their phone. Great for registration, checkout, and multi-step forms.
What You Can Do
- Build forms with AI — describe what you need in plain English and generate complete forms
- Share Hosted Form links — give visitors a branded landing page at
f.singleform.ai/{code}without embedding anything - Print QR codes — download branded QR codes in PNG or SVG for scanning with the mobile app
- Receive form submissions via secure webhook POST requests
- Verify authenticity with HMAC-SHA256 signed headers for both webhooks and QR codes
- Return structured responses that SingleForm displays to users (success messages, validation errors, etc.)
- Use official middleware for Node.js, Python, and Ruby — zero-config webhook verification
Get Started
Webhook Headers
Every request to your endpoint includes these signed headers:
| Header | Description |
|---|---|
X-SingleForm-Signature | HMAC-SHA256 hex digest of the request |
X-SingleForm-Timestamp | Unix timestamp (seconds) when the request was created |
X-SingleForm-Nonce | Unique identifier for this request |
X-SingleForm-Form-Id | The ID of the form that was submitted |