Documentation

Everything you need to ship a form.

Create a form, drop in the endpoint, and start receiving submissions in your inbox — no code beyond a plain HTML form.

01Quickstart

Receive your first submission in under 60 seconds.

1. In the dashboard sidebar, click + CreateForm Endpoint. Give it a name (e.g. support-request), optionally file it under a workspace, and set the timezone used for submission timestamps. Click Create Form.

Create New Form modal with endpoint name, workspace, and timezone fields
Creating a new form endpoint from the dashboard.

2. Open the form and copy its endpoint URL:

POSThttps://app.formbridge.ai/api/forms/fb_8h2k9p

3. Point your form at it — pick your framework:

HTML React Next.js Vue
<form action="https://app.formbridge.ai/api/forms/fb_8h2k9p" method="POST">
  <input name="full-name" placeholder="Full name"/>
  <input name="email" type="email"/>
  <textarea name="message"></textarea>
  <button type="submit">Send</button>
</form>

4. Submit it. Every submission runs the same pipeline, visible on the submission itself in your inbox:

Submission receivedSpam check passedEmail notification sent to your recipient list → Autoresponder sent to the submitter's email address.

No SDK to install and no schema to define first — any field name works, and any backend that can send an HTTP POST can use the same endpoint:

curl -X POST https://app.formbridge.ai/api/forms/fb_8h2k9p \
  -H "Accept: application/json" \
  -d "full-name=Alex" \
  -d "email=alex@example.com" \
  -d "message=Hello"

Returns { "ok": true, "id": "sub_882j4i211ek95" } on success.

02Forms & workspaces

Every form you create is a Form Endpoint — a name, an endpoint URL, and its own inbox, settings, and email configuration. Endpoints can live directly on your account or inside a Workspace, a folder used to group related forms and scope team access (e.g. one workspace per client or per site).

From a form's detail page you can rename its Display name inline, move it between workspaces via Folder location, copy its Endpoint URL, or permanently Delete form.

Workspaces are managed from Workspaces in the sidebar:

Workspace name
text
Editable at any time. Doesn't affect the endpoint URLs of forms inside it.
Members
count
People with access to this workspace and everything in it.
Forms
count
Number of form endpoints filed under this workspace.
Your role
Owner / Manager / Guest
Owner has full control. Manager can view and manage submissions. Guest access is invite-scoped.

03Field naming

FormBridge accepts any input name — there's no required prefix and nothing to register in advance. We recommend hyphenated, descriptive names because they're auto-formatted for display in your inbox and turned into a merge tag you can drop into notification and autoresponder emails.

full-name
Full-Name
Shown as "Full-Name" in the inbox. Merge tag: {{Full-Name}}.
email
Email
A field of type email is used as the reply-to address for autoresponders. Merge tag: {{Email}}.
phone-number
Phone-Number
Merge tag: {{Phone-Number}}.

On top of a merge tag per field, every template also has access to three system tags: {{FormName}}, {{DashboardUrl}}, and {{AllFields}} (every submitted field, formatted as one block).

A submission detail panel showing hyphenated field names auto-formatted as labels
A submission's fields, auto-formatted for display from their input names.

04The inbox

Every submission lands in your form's Inbox, split from filtered Spam in a separate tab. Selecting a submission shows its status, a unique ID (sub_882j4i211ek95), and every field it submitted, plus the processing log for that exact submission — received, spam-checked, notified, auto-responded.

Use the toolbar to Refresh, toggle visible Columns, or Export CSV. The top nav search bar searches across submissions and forms account-wide.

Inbox list of submissions next to a submission detail panel with its processing activity log
The Inbox: submission list on the left, detail and activity log on the right.

05File uploads

Add a file input with enctype="multipart/form-data" — no separate configuration needed:

<form action="https://app.formbridge.ai/api/forms/fb_8h2k9p"
      method="POST"
      enctype="multipart/form-data">
  <input type="file" name="resume" accept=".pdf,.doc"/>
</form>

Uploads are stored encrypted and appear as a secure link on the submission in your inbox. Files count against your plan's total file storage — shown live on your Usage page.

06Email notifications

Configure who's alerted when a form is submitted from Form → Email Settings → Notifications:

  • Recipient list — the main addresses that get notified on every submission.
  • CC recipient list — additional addresses copied on the same email.
  • Notification email subject — supports the {{FormName}} placeholder, e.g. "New Submission - {{FormName}}".

Each form also shows its Owner — the account the form belongs to — for reference.

07Slack & Discord notifications

Post a message to a Slack or Discord channel every time a form submission arrives, in addition to (or instead of) email. Add your channel's webhook URL from the form's notification settings — one channel per form.

Plan: available on Pro and above. See Plans & limits.

08Custom email templates

Design the notification email visually from Form → Email Settings → Custom Template. Start from Load FormBridge layout or build from scratch by dragging in blocks — Columns, Button, Divider, Heading, Paragraph, Image, Social, HTML — then Preview before you Save template.

Every field on the form gets its own merge tag automatically (click any tag in the picker to copy it), alongside the system tags {{FormName}}, {{DashboardUrl}}, and {{AllFields}}.

Branding — logo, primary color, button color, card background, and an editable footer — is configured separately for notification emails and autoresponder emails, so the two can look different if you want.

Drag and drop email builder with content blocks and a list of clickable merge tags
The drag-and-drop builder, with every field available as a merge tag.

09Autoresponder

Send an automatic reply to whoever submitted the form from Form → Email Settings → Autoresponder. Set a subject and body, and use the same field merge tags as notifications (e.g. {{Full-Name}}):

Dear {{Full-Name}},

Thank you for reaching out. We've received your submission
and will get back to you shortly.

Write the body as plain rich text, or flip Use Drag & Drop Email Builder to design it the same way as a custom notification template. Autoresponder branding is configured separately from admin notifications. Avoid large embedded images — they inflate the email size for every reply sent.

10Spam protection

Every submission is scored automatically before it reaches your inbox — no setup required. Submissions that fail the check are routed to the Spam tab instead of your inbox. Layer on optional protection from Form → Settings → Spam Protection:

  • CAPTCHA — choose No CAPTCHA, reCAPTCHA, or hCaptcha, each configured with a site key and secret key from your Google/hCaptcha account.
  • Authorized domains — an allow-list of domains submissions may come from. Leave empty to accept submissions from anywhere.
  • Honeypot — adds a hidden field (default name honeypot, or set your own) that silently rejects any submission that fills it in, since real visitors never see it.
Form Settings Spam Protection tab listing CAPTCHA, Authorized domains, and Honeypot with configure buttons
Spam Protection settings for a form — each layer optional and independently configured.

11Custom SMTP

Send notifications and autoresponders from your own domain instead of FormBridge's default sender. Add a server under Account → SMTP Configurations → + Add SMTP Server:

SMTP Host
required
e.g. smtp.gmail.com.
Port
required
e.g. 587.
Encryption
TLS / SSL / None
Match what your provider expects.
Username
required
Usually the full sending email address.
Password
required
Your SMTP account password or app password.
From name
required
The display name recipients see, e.g. your company name.

Each SMTP account can be assigned to one or more forms — a form only ever sends through one account, and assigning it here moves it off any other. Click Test SMTP before saving.

Note: a form also needs a Notification email set under its own Email Settings for custom SMTP delivery to take effect.
SMTP Configurations list showing two SMTP accounts and the forms assigned to each
Configured SMTP accounts, each tied to specific forms.

12Team & collaboration

Invite teammates from Account → Members → Invite. Enter one or more comma-separated email addresses, assign a role, and scope access to specific workspaces or individual forms using the checkbox tree.

  • Owner — full control over the workspace or form, including billing and deletion.
  • Manager — can view and manage submissions.
  • Guest — limited, invite-scoped access.

Pending invitations can be Accepted or Declined from the same page. Use My Team / Shared with Me to switch between people you've invited and workspaces others have shared with you. Team size is limited by your plan — see Plans & limits.

Collaboration page with active plan limit, members list, and My Team / Shared with Me toggle
Collaboration — invite, assign roles, and track your plan's member limit.

13Account & security

Manage your profile — name, email, company, and photo — from Account. From the same area:

  • Change password — requires your current password.
  • Two-factor authentication — protect sign-in with a code from an authenticator app (Google Authenticator, Authy, or similar).
  • Passkeys — sign in with your device's face, fingerprint, or PIN instead of a password.

Billing shows your current plan, lets you upgrade, and keeps a history of past charges. Usage shows live progress against your plan's submission, storage, form, and workspace limits.

14Plans & limits

A quick reference for what each plan includes. Full feature-by-feature comparison is on the pricing page.

Limit
Free
Pro
Business
Enterprise
Forms
2
20
100
Unlimited
Monthly submissions
1,000
25,000
100,000
Custom
File storage
1 GB
2 GB
10 GB
Custom
Team members
1
5
15
Unlimited
Workspaces
1
5
Unlimited
Unlimited

Custom SMTP, custom email templates, CSV export, and Slack/Discord notifications are available from Pro up. SSO/SAML is available on Enterprise.

See full pricing details

15Roadmap

Actively in development — not available yet on any plan:

  • WebhooksComing soon — a signed JSON payload delivered to your own URL for every submission.
  • API accessComing soon — read and manage forms and submissions programmatically via a REST API.

Follow progress on the changelog, or get in touch if either is a blocker for you.

Stuck? We're one message away.

Open a ticket or join the beta Slack — we triage daily and ship fixes weekly.