n8n-nodes-formbricks-new

This is an n8n community trigger node for Formbricks survey events.

It registers Formbricks webhooks for selected surveys and emits incoming survey webhook payloads into an n8n workflow.

Package

Published package name:

n8n-nodes-formbricks-new

This name follows the n8n community node package requirements: unscoped community node packages must start with n8n-nodes-, and the package includes the n8n-community-node-package keyword.

This package uses a new npm name because n8n-nodes-formbricks already exists on npm.

Installation

After publishing to npm, install the package in a self-hosted n8n instance:

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter the npm package name: n8n-nodes-formbricks-new.
4. Accept the community node warning and install.

Manual installation is also possible from the n8n custom nodes directory:

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-formbricks-new

Restart n8n after manual installation.

For an unpublished local build, create a tarball from this repository and install that file:

npm run build
npm pack
cd ~/.n8n/nodes
npm install /path/to/n8n-nodes-formbricks-new-1.0.7.tgz

Restart n8n after installing the local tarball.

Credentials

Create Formbricks API credentials in n8n with:

• Host: your Formbricks base URL, for example https://form.example.com
• API Key: your Formbricks organization API key

The credential test calls:

GET /api/v2/me

Required Permissions

Formbricks API keys are organization-level keys with separate organization and workspace permissions.

This node uses these Formbricks API v2 endpoints:

• GET /api/v2/me to test credentials and load the workspace list
• GET /api/v2/management/webhooks to check for an existing webhook
• POST /api/v2/management/webhooks to register the n8n production webhook
• DELETE /api/v2/management/webhooks/{id} to remove the webhook when the workflow is deactivated

It also uses GET /api/v1/management/surveys to load survey choices in n8n because the current public API v2 documentation does not expose a survey list endpoint.

Recommended permissions for the full n8n trigger lifecycle:

• Organization access: Read
• Selected workspace access: Manage

Lower workspace permissions have limited behavior:

• Read: Credentials and workspace loading can work, but webhook creation fails.
• Write: Webhook creation can work, but webhook deletion during workflow deactivation can fail.
• Manage: Webhook creation, lookup, and deletion can all work.

The credential test only verifies GET /api/v2/me, so it can confirm the API key and Organization Read access. It does not prove that the selected workspace has Write or Manage access; that is checked later when n8n activates or deactivates the workflow.

Workspace Selection

Workspace is selected in the Formbricks trigger node, not in the credential.

The node loads available workspaces from the current Formbricks API v2:

curl -H "x-api-key: <API_KEY>" https://form.example.com/api/v2/me

It uses the returned workspaces[] array. It also supports Formbricks responses that expose the same data as workspacePermissions[]. The option label is based on projectName or workspaceName, includes the permission level when returned by Formbricks, and the option value is workspaceId.

Usage

1. Add the Formbricks trigger node to an n8n workflow.
2. Select the workspace that should receive the webhook.
3. Select one or more events, for example Response Finished.
4. Optionally select surveys. Leave Survey IDs empty to trigger this node for all surveys in the workspace.
5. Save and activate the workflow.

When the workflow is activated, n8n creates a production webhook URL and the node registers it in Formbricks with:

{
  "name": null,
  "workspaceId": "<WORKSPACE_ID>",
  "url": "https://n8n.example.com/webhook/...",
  "source": "n8n",
  "triggers": ["responseFinished"],
  "surveyIds": ["<SURVEY_ID>"]
}

For production delivery, activate the workflow and use the Production Webhook URL. Production URLs use /webhook/....

The /webhook-test/... URL is only for temporary test listening in the n8n editor. After test listening stops, Formbricks deliveries to /webhook-test/... will return 404.

If n8n is behind a reverse proxy, configure n8n's public webhook base URL, for example:

WEBHOOK_URL=https://n8n.example.com/

Development

Install dependencies:

npm install

Build:

npm run build

Run lint if available:

npm run lint

Check package contents:

npm pack --dry-run

Publish:

npm adduser
npm login
npm version patch
npm publish

Publishing is optional for local use. It requires an npm account logged in on the publishing machine.

Compatibility

This package is based on the upstream Formbricks n8n node and was updated to register webhooks through the Formbricks API v2 management webhook endpoints.

Formbricks API v2 currently exposes webhook management under /api/v2/management/webhooks. Survey choices are loaded through /api/v1/management/surveys until an API v2 survey list endpoint is available.

Resources

• n8n community nodes documentation
• Formbricks API v2 reference
• Formbricks API v2 Me
• Formbricks API v2 webhook API