n8n-nodes-formhook

n8n community node package with FormHook node for receiving form data with text and image inputs.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-formhook

Features

Form Hook Node

A webhook node that receives form data with support for:

Text Input:

• ✅ Keyboard input
• ✅ Paste text
• ✅ Drag and drop text files

Image Input:

• ✅ Paste image on hover
• ✅ Click to select image file
• ✅ Drag and drop image files

Usage

1. Add Form Hook Node

1. Create a new workflow in n8n
2. Add the "Form Hook" node from the node panel
3. Configure the node:
   • Path: Webhook path (default: formhook)
   • Response Mode: Choose how to handle webhook response

2. Activate Workflow

1. Click "Activate" button
2. Copy the generated webhook URL (e.g., http://localhost:5678/webhook/formhook)

3. Use HTML Form

Use the provided HTML form (nodes/FormHook/form.html) or send POST requests directly:

curl -X POST http://localhost:5678/webhook/formhook \
  -F "text=Your text here" \
  -F "image=@/path/to/image.png"

4. Receive Data

The node outputs data in the following format:

{
  "text": "User input text",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "image": {
    "data": "base64 encoded image data",
    "mimeType": "image/png",
    "fileName": "image.png"
  }
}

HTML Form

The package includes a complete HTML form (nodes/FormHook/form.html) with:

• Modern, responsive UI
• Support for all input methods
• Drag and drop functionality
• Image preview
• Form validation

To use the HTML form:

1. Deploy nodes/FormHook/form.html to your web server
2. Set the webhook URL in the form
3. Users can access the form to submit data

Development

Setup

npm install

Build

npm run build

Development Mode

npm run dev

This starts n8n with your node loaded and hot reload enabled.

Lint

npm run lint
npm run lint:fix

Resources

• n8n community nodes documentation
• n8n Node Documentation
• n8n Community Forum

License

MIT