# FormBack

> Form backend service for static sites. Receive form submissions via email, webhooks, Slack, and Discord — no server code needed.

Website: https://formback.email
API Base: https://api.formback.email
Documentation: https://formback.email/docs

## What is FormBack?

FormBack is a form backend-as-a-service. Point your HTML form's `action` to a FormBack endpoint and receive submissions via email notifications, webhooks, Slack, or Discord. No backend code required.

## Key Features

- **Email Notifications** — Get an email for every new submission
- **Webhooks** — Forward submissions to any URL (Slack, Zapier, your own API)
- **Slack & Discord Integration** — Native webhook support for Slack and Discord
- **Spam Protection** — Built-in honeypot field (`_gotcha`)
- **File Uploads** — Accept file attachments (up to 5 files, 10MB each, 25MB total)
- **Custom Redirects** — Redirect users to a thank-you page after submission (`_next` field)
- **REST API** — Full API for managing forms, submissions, and files
- **MCP Support** — Model Context Protocol server for AI assistants (Claude, Cursor)
- **API Keys** — Scoped API keys with optional per-form restrictions

## Pricing

| Plan     | Price    | Submissions/mo | Forms     | Key Features                                      |
|----------|----------|-----------------|-----------|---------------------------------------------------|
| Free     | €0       | 50              | 1         | Email notifications, honeypot spam filter          |
| Starter  | €9/mo    | 1,000           | 10        | File uploads, custom redirects                     |
| Pro      | €29/mo   | 10,000          | Unlimited | Webhooks, spam protection, no branding             |
| Business | €79/mo   | 50,000          | Unlimited | API access, priority support                       |

## Quick Start

1. **Sign up** at https://formback.email/login
2. **Create a form** in your dashboard — click "New Form" and copy the endpoint URL
3. **Add to your HTML:**

```html
<form action="https://api.formback.email/f/YOUR_FORM_ID" method="POST">
  <input type="text" name="name" placeholder="Name" required>
  <input type="email" name="email" placeholder="Email" required>
  <textarea name="message" placeholder="Message"></textarea>
  <button type="submit">Send</button>
</form>
```

## API Endpoints

All API requests require `Authorization: Bearer YOUR_API_KEY` header.

| Method | Endpoint                              | Description              |
|--------|---------------------------------------|--------------------------|
| POST   | `/f/:formId`                          | Submit form (public)     |
| GET    | `/api/forms`                          | List all forms           |
| POST   | `/api/forms`                          | Create a form            |
| GET    | `/api/forms/:id`                      | Get form details         |
| PATCH  | `/api/forms/:id`                      | Update form settings     |
| DELETE | `/api/forms/:id`                      | Delete a form            |
| GET    | `/api/forms/:id/submissions`          | List submissions         |
| GET    | `/api/submissions/:id`                | Get single submission    |
| DELETE | `/api/submissions/:id`                | Delete submission        |
| GET    | `/api/submissions/:id/files/:fileId`  | Download file            |
| GET    | `/api/account`                        | Get account info & usage |
| GET    | `/api/keys`                           | List API keys            |
| POST   | `/api/keys`                           | Create API key           |
| DELETE | `/api/keys/:id`                       | Delete API key           |

## MCP Server (AI Integration)

FormBack provides an MCP (Model Context Protocol) server for AI assistants like Claude and Cursor.

Install: `npx @formback/mcp`

### Claude Desktop Configuration

```json
{
  "mcpServers": {
    "formback": {
      "command": "npx",
      "args": ["@formback/mcp"],
      "env": { "FORMBACK_API_KEY": "your_api_key_here" }
    }
  }
}
```

### Available MCP Tools

- `list_forms` — List all your forms
- `create_form` — Create a new form endpoint
- `get_form` — Get form details and settings
- `update_form` — Update form name, webhook, redirect URL
- `delete_form` — Delete a form
- `get_submissions` — List submissions for a form
- `delete_submission` — Delete a specific submission

## Special Form Fields

- `_gotcha` — Honeypot spam protection (hidden field; submissions with a value are silently rejected)
- `_next` — Custom redirect URL after submission

## File Uploads

Use `enctype="multipart/form-data"` on your form. Limits: max 5 files, 10MB per file, 25MB total per submission.

## Links

- Website: https://formback.email
- Documentation: https://formback.email/docs
- Login / Sign Up: https://formback.email/login
- Full LLM documentation: https://formback.email/llms-full.txt