Data syncConnectorsAutomation
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 gets | Each response starts a workflow |
| Events | Survey submitted, and Survey partially submitted when ticked |
| Anonymous respondents | Supported, with Include anonymous respondents on |
| Status | Available |
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_URLset to that address). Encatch never calls private addresses or other ports - About 5 minutes
Step 1: Add the Webhook node in n8n
- In n8n, create a workflow and add a Webhook node.
- Set HTTP Method to POST.
- Optional, recommended: under Authentication, choose Header Auth and create a credential with Name
X-Encatch-Secretand a Value of your choice. - Copy the Test URL and click Listen for test event.
Step 2: Add the connection in Encatch
- In Encatch, open Data sync → Survey events and click Add connection.
- Choose n8n and enter a Name.
- Fill in the settings:
| Field | What to enter |
|---|---|
| Webhook URL | The Test URL for now. You'll swap it for the Production URL in Step 3. |
| Secret | Optional. The same value you set in the Header Auth credential. |
- 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
- In n8n, build the rest of the workflow and Publish it.
- In the Webhook node, copy the Production URL.
- In Encatch, paste it in Webhook URL instead of the Test URL and click Save.
- 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.statuspartialand 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.anonymoustrue,user.idempty anduser.anonymous_idset. - Repeats. A retry can deliver a response twice: use
body.event_idto 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 shows | What it means | What to do |
|---|---|---|
| n8n has no active workflow at this URL | The workflow isn't published, or the path changed | Publish the workflow; copy the Production URL again |
| n8n's Test URL takes one call | A Test URL is saved | Paste the Production URL |
| No n8n instance at this address | The instance name is wrong | Copy the URL again from the Webhook node |
| n8n refused the secret | Secret and Header Auth value differ | Enter the same value in both |
| The webhook URL must use the standard HTTPS port | Self-hosted n8n on a port such as 5678 | Put n8n behind HTTPS on port 443 |
Was this page helpful?
