From c656c19cce665838f4a7af5eebf0232d8386d65d Mon Sep 17 00:00:00 2001 From: Justin Ellingwood Date: Wed, 28 May 2025 11:40:45 +0100 Subject: [PATCH] Add note about one webhook per path and method combo (#3204) --- .../n8n-nodes-base.webhook/common-issues.md | 13 +++++++++++-- .../core-nodes/n8n-nodes-base.webhook/index.md | 2 +- 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/common-issues.md b/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/common-issues.md index 4ca3424e5..c6f856478 100644 --- a/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/common-issues.md +++ b/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/common-issues.md @@ -94,8 +94,17 @@ While building or testing a workflow, use the **Test URL**. Once you're ready to Refer to [Workflow development](/integrations/builtin/core-nodes/n8n-nodes-base.webhook/workflow-development.md) for more information. -## IPs in Whitelist are failing to connect +## IP addresses in whitelist are failing to connect -If you're unable to connect from IPs in your IP Whitelist, check if you are running n8n behind a reverse proxy. +If you're unable to connect from IP addresses in your IP whitelist, check if you are running n8n behind a reverse proxy. If so, set the `N8N_PROXY_HOPS` [environment variable](/hosting/configuration/environment-variables/index.md) to the number of reverse-proxies n8n is running behind. + +## Only one webhook per path and method + +n8n only permits registering one webhook for each path and HTTP method combination (for example, a `GET` request for `/my-request`). This avoids ambiguity over which webhook should receive requests. + +If you receive a message that the path and method you chose are already in use, you can either: + +* Deactivate the workflow with the conflicting webhook. +* Change the webhook path and/or method for one of the conflicting webhooks. diff --git a/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/index.md b/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/index.md index a98ec0a82..e98cb7eda 100644 --- a/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/index.md +++ b/docs/integrations/builtin/core-nodes/n8n-nodes-base.webhook/index.md @@ -111,7 +111,7 @@ Select **Add Option** to view more configuration options. The available options * **Allowed Origins (CORS)**: Set the permitted cross-origin domains. Enter a comma-separated list of URLs allowed for cross-origin non-preflight requests. Use `*` (default) to allow all origins. * **Binary Property**: Enabling this setting allows the Webhook node to receive binary data, such as an image or audio file. Enter the name of the binary property to write the data of the received file to. * **Ignore Bots**: Ignore requests from bots like link previewers and web crawlers. -* **IP(s) Whitelist**: Enable this to limit who (or what) can invoke a Webhook trigger URL. Enter a comma-separated list of allowed IP addresses. Access from IPs outside the whitelist throws a 403 error. If left blank, all IP addresses can invoke the webhook trigger URL. +* **IP(s) Whitelist**: Enable this to limit who (or what) can invoke a Webhook trigger URL. Enter a comma-separated list of allowed IP addresses. Access from IP addresses outside the whitelist throws a 403 error. If left blank, all IP addresses can invoke the webhook trigger URL. * **No Response Body**: Enable this to prevent n8n sending a body with the response. * **Raw Body**: Specify that the Webhook node will receive data in a raw format, such as JSON or XML. * **Response Content-Type**: Choose the format for the webhook body.