n8n-nodes-nativeform

This is an n8n community node for NativeForm - the AI-native form builder.

It lets you trigger n8n workflows when your NativeForm receives a new submission.

Installation

In n8n Desktop/Self-hosted

1. Go to Settings > Community Nodes
2. Click Install a community node
3. Enter n8n-nodes-nativeform
4. Click Install

In n8n Cloud

Community nodes are available in n8n Cloud. Follow the same steps above.

Credentials

You need a NativeForm API key to use this node:

1. Open any form in NativeForm
2. Go to the Export tab
3. Create an API key
4. Copy the key (it's only shown once!)

In n8n:

1. Go to Credentials > Add Credential
2. Search for "NativeForm API"
3. Paste your API key
4. (Optional) Change the base URL if self-hosting NativeForm

Nodes

NativeForm Trigger

Triggers your workflow when a form submission is received.

Parameters:

• Form: Select which form to listen to
• Event: Currently only form.submitted

Output:

{
  "event": "form.submitted",
  "form": {
    "id": "abc123",
    "name": "Contact Form",
    "slug": "contact-form"
  },
  "response": {
    "id": "resp_456",
    "channel": "WEB",
    "submittedAt": "2024-01-15T10:30:00.000Z",
    "metadata": {}
  },
  "respondent": {
    "id": "user_789",
    "displayName": "John Doe",
    "contact": { "email": "john@example.com" }
  },
  "answers": [
    {
      "fieldKey": "email",
      "fieldLabel": "Email Address",
      "fieldType": "EMAIL",
      "value": "john@example.com",
      "rawText": "john@example.com"
    }
  ]
}

How It Works

1. When you activate a workflow with the NativeForm Trigger:

   • The node creates a webhook on your NativeForm via API
   • The webhook URL points to your n8n instance

2. When someone submits your form:

   • NativeForm sends the submission data to n8n
   • The payload is signed with HMAC-SHA256 for security
   • Your workflow receives the data and continues

3. When you deactivate the workflow:

   • The node automatically removes the webhook from NativeForm

Security

All webhook payloads are signed using HMAC-SHA256. The node automatically:

• Requests a signing secret when creating the webhook
• Verifies the signature on every incoming request
• Rejects requests with invalid or expired signatures (5-minute window)

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT