n8n
The n8n-nodes-50heads community node asks real people a question from an n8n workflow, brings the results back, and starts workflows when a question closes. It calls the same API as everything else, with an API key.
Install
In n8n, open Settings, Community Nodes, Install, and enter n8n-nodes-50heads. The package has no runtime dependencies.
Credentials and scopes
Make an API key under Developers in the portal and add it to a 50heads API credential. n8n sends it as Authorization: Bearer fh_live_… and tests it with GET /v1/me.
| Scope | Needed for |
|---|---|
questions:read | Get Results |
questions:write | Ask |
webhooks:read, webhooks:write | 50heads Trigger, which adds and removes its own endpoint |
Operations
| Operation | API | What it does |
|---|---|---|
| Estimate | POST /v1/billing/estimate | The price and any validation problems, without asking. priceText reads like "$13 for 50 heads". |
| Ask | POST /v2/questions | Reserves the full price and asks. The Idempotency-Key is your own, or n8n:<execution>:<node>:<item>, so a retried item asks once. A 202 approval_required comes out as status: "pending_approval". |
| Get Results | GET /v2/questions/{id}/result, or /wait | The result so far, or, with Wait Until Closed, long-polls /wait (25 seconds a call) until the question closes or Max Wait runs out. |
Trigger
Activating a workflow with the 50heads Trigger creates a webhook endpoint (POST /v1/webhooks/endpoints, description n8n) for the node's production URL and keeps its signing secret in the workflow's static data. Deactivating deletes it. Each delivery is verified with Standard Webhooks (HMAC-SHA256 over webhook-id.webhook-timestamp.body, a five-minute window) using node:crypto; anything that does not verify gets 401 and starts nothing. Items carry the event's data plus eventId, eventType and questionUrl. See Webhooks for the events.