Build workflows with the Facehunch REST API. This community node sends ordinary HTTP resource requests and returns JSON responses. It does not connect to an MCP server or use JSON-RPC.

Installation

Install n8n-nodes-facehunch from Settings → Community nodes in your n8n instance. You can also install the npm package in a self-hosted n8n installation.

Authentication

Create the Facehunch OAuth2 API credential, select Connect my account, sign in to Facehunch, and approve the listed permissions. Credentials use dynamic registration, OAuth authorization code flow, PKCE, expiring access tokens, and refresh tokens. The API resource is https://mcp.facehunch.com/v1; REST tokens are separate from MCP tokens.

Upgrading from 1.x: reconnect the credential before running workflows. Version 2 replaces the old MCP transport with the native REST API. Inputs retain their names, while outputs are the API's resource JSON. Review existing workflows before enabling writes.

Operations

Operation	HTTP request
Read your Facehunch profile	`GET /v1/account`
Read an existing report	`GET /v1/reports/:reportId`
List your reports	`GET /v1/reports`

Workflow behavior

Each input item makes one API request and produces one linked output item. Optional pagination fields can be passed through the node's options; list responses retain their next-page cursor or offset. Write operations require the node's explicit confirmation switch. Failed requests stop the workflow unless Continue On Fail is enabled. HTTP errors are summarized without including credentials or raw request headers.

Requests use the fixed product API origin, encode resource identifiers, and do not follow redirects. Use a dedicated account for automation when you want separate access and data. Account ownership, workspace permissions, billing limits, and entitlement checks are enforced by the product API.

Development and support

Run npm ci, npm run lint, and npm test to build and validate the package with the n8n node CLI. Source and release automation: facehunch/n8n-nodes-facehunch. Report node issues in GitHub Issues.

Product: Facehunch · Privacy · Agent skill · MCP integration

MIT license.