Welcome to Encatch Docs
Data syncBetaConnectorsAutomation

n8n

Start an n8n workflow with each Encatch survey response - where to set up the Webhook node in n8n and how to connect it

Overview

The n8n connector sends each survey response to an n8n workflow through a Webhook node, on n8n Cloud or your own n8n.

What it getsEach response starts a workflow
EventsSurvey submitted, and Survey partially submitted when ticked
Anonymous respondentsSupported, with Include anonymous respondents on
StatusAvailable

What You'll Need

Before you start, make sure you have:

  • An n8n instance — n8n Cloud works as is. Self-hosted n8n must be reachable from the internet over HTTPS on port 443 (behind a reverse proxy, with n8n's WEBHOOK_URL set to that address). Encatch never calls private addresses or other ports
  • About 5 minutes

Step 1: Add the Webhook node in n8n

  1. In n8n, create a workflow and add a Webhook node.
  2. Set HTTP Method to POST.
  3. Optional, recommended: under Authentication, choose Header Auth and create a credential with Name X-Encatch-Secret and a Value of your choice.
  4. Copy the Test URL and click Listen for test event.

Step 2: Add the connection in Encatch

  1. In Encatch, open Data sync → Survey events and click Add connection.
  2. Choose n8n and enter a Name.
  3. Fill in the settings:
FieldWhat to enter
Webhook URLThe Test URL for now. You'll swap it for the Production URL in Step 3.
SecretOptional. The same value you set in the Header Auth credential.
  1. Pick the surveys, click Save, then press Test connection. n8n shows the response in the Webhook node.

Step 3: Publish and switch to the Production URL

  1. In n8n, build the rest of the workflow and Publish it.
  2. In the Webhook node, copy the Production URL.
  3. In Encatch, paste it in Webhook URL instead of the Test URL and click Save.
  4. Press Start sending.

n8n puts the payload under body, next to the request headers: map answers from {{ $json.body.response.answers }}. The fields are described in the payload reference.


Good to know

  • The Test URL takes one call after each Listen for test event; afterwards it answers "not registered". The form warns while a Test URL is saved.
  • The Production URL works only while the workflow is published.
  • Partial responses arrive with response.status partial and the answers given so far, once, when Encatch closes the response. A response is sent as partial or as submitted, never both.
  • Anonymous respondents arrive with user.anonymous true, user.id empty and user.anonymous_id set.
  • Repeats. A retry can deliver a response twice: use body.event_id to skip repeats.
  • Rate limit. n8n has no request limit. n8n Cloud runs a few workflows at once (5 to 200 by plan) and queues the rest.

Troubleshooting

What Encatch showsWhat it meansWhat to do
n8n has no active workflow at this URLThe workflow isn't published, or the path changedPublish the workflow; copy the Production URL again
n8n's Test URL takes one callA Test URL is savedPaste the Production URL
No n8n instance at this addressThe instance name is wrongCopy the URL again from the Webhook node
n8n refused the secretSecret and Header Auth value differEnter the same value in both
The webhook URL must use the standard HTTPS portSelf-hosted n8n on a port such as 5678Put n8n behind HTTPS on port 443

Was this page helpful?