# FormCrab

> Hosted private form links to receive messages securely without exposing your email address.

FormCrab provides a minimalist, zero-code privacy shield between the public-facing internet and your inbox. Instead of embedding vulnerable HTML forms or `mailto:` links that web scrapers easily crawl, FormCrab hosts the complete form UI, landing page, and backend securely on a private tokenized link.

## Core Features

- **Email Privacy:** Keeps your actual email address 100% invisible to scraping bots and spam networks.
- **Zero-Code Hosted UI:** No HTML to write, no infrastructure to configure, and no hosting fees. We provide the form page and backend handler.
- **Universal Sharing:** Perfect for GitHub READMEs, Twitter/X bios, Notion pages, Linktree, or static blogs.
- **Anti-Spam Edge Protection:** Advanced request verification and bot mitigation at the network edge.

---

## How to create my private link?

1. go to formcrab.com.
2. In home page, type your email, and hit button 'Get My Private Link', will show your private link.
3. open your private link, submit first message, then your email will receive activate email.


## Link Customization (URL Parameters)

You can append standard HTTP GET parameters to your unique FormCrab private link to pre-fill inputs or manipulate the post-submission workflow.

Replace `{custom-link}` with your unique token identifier.

### Available Query Parameters

| Parameter | Purpose | Example URL |
| :--- | :--- | :--- |
| `name` | Auto-fills the visitor's name input field. | `https://formcrab.com/f/{custom-link}?name=Hugh` |
| `email` | Pre-sets the visitor's email address input field. | `https://formcrab.com/f/{custom-link}?email=customer@company.com` |
| `subject` | Sets a predefined subject to categorize incoming messages. | `https://formcrab.com/f/{custom-link}?subject=Urgent+Support+Request` |
| `message` | Pre-fills the main textarea with a template message to guide users. | `https://formcrab.com/f/{custom-link}?message=I+would+like+to+request+a+demo` |
| `next` | Overrides the default "Thank You" success page with a custom redirect URL. | `https://formcrab.com/f/{custom-link}?next=https://yoursite.com/success` |

---

## Webhook Integration

FormCrab supports asynchronous outbound data relays via Webhooks. When a user submits your hosted form, FormCrab can dispatch an automated HTTP POST request to your designated listener URL.

### Outbound POST Payload Format

Submissions are transmitted as a flat JSON object containing explicit customer fields alongside structured metadata.

```json
{
  "name": "Hugh",
  "email": "hello@hugh.com",
  "subject": "hello! there",
  "message": "hello! there",
  "submittedAt": "2026-03-12 10:20:08",
  "extra": {
    "key1": "value1",
    "key2": "value2"
  }
}