Skip to content
New: a free website for your business, live in 48 to 72 hoursWorkflow automation on n8n and Claude, built for your businessFixed price, agreed before we start · Live in 5 to 10 business days30-day money-back guarantee on every planProfessional firms · Agencies · E-commerceYou own every workflow, in your own n8nClaude API: your data is not used for trainingHuman approval on every sensitive stepFree automation audit, no obligation
PURIST
30 days
Money-back window
14 h/wk
Modeled time saved
99.97%
Uptime SLA
< 7 days
Deploy time
PURIST AI
Claude Opus 4.7 · n8n v1.71 · <80ms
What type of business are you running? I'll show you exactly which processes we'd automate first and your estimated ROI.
Powered by n8n + Claude Opus 4.7 Get my free automation plan →
Fix n8n "The requested webhook is not registered" (Test and Production)
Guides 7 min read · 1,391 words

Fix n8n "The requested webhook is not registered" (Test and Production)

The 404 "webhook is not registered" error almost always means the URL and the workflow state do not match. Five causes and the exact fix for each, test and production.

Steve, founder of PURIST

November 6, 2026

PURIST: Stuck on n8n? Our n8n experts fix and build workflows like this one, at a fixed price →

"The requested webhook is not registered" is the 404 response n8n sends when a request reaches a webhook address that nothing is listening on at that moment. The webhook itself is usually fine. What is wrong is the combination of URL, method and workflow state. Five checks fix nearly every case.

In short. A Test URL (/webhook-test/...) only listens for 120 seconds after you click "Listen for test event". A Production URL (/webhook/...) only listens while the workflow is published (called "active" in n8n 1.x). Use the URL that matches the state, send the same HTTP method the node expects, and check that the path has not changed.

Fix n8n "The requested webhook is not registered" (Test and Production): workflow diagram
The Test URL listens 120 seconds; the Production URL listens while the workflow is published. Illustration: PURIST.

Cause 1: you called the Test URL without listening

Each Webhook node has two addresses. The documentation summarises them like this:

URL typeHow to triggerListening durationData shown in the editor
Test URLClick "Listen for test event", then send the request120 secondsYes
Production URLPublish the workflowUntil it is unpublishedNo (see the Executions tab)

So if you paste the Test URL into Stripe, Typeform or a website form and the request arrives later, n8n is no longer listening and answers 404. Fix: click "Listen for test event" right before sending a test, or use the Production URL for anything that is not a manual test.

Cause 2: you called the Production URL of an unpublished workflow

The Production URL is registered only when the workflow is published. Save the workflow, publish it, then call the URL again. Remember that production executions do not appear on the canvas: open the Executions tab to see them. Many people think the webhook "did nothing" when it actually ran.

Fix n8n "The requested webhook is not registered" (Test and Production): node settings
The four Webhook node fields to compare with what the sender uses. Illustration: PURIST.

Cause 3: the HTTP method does not match

A Webhook node accepts one method by default, for example POST. A GET request to the same path is not registered and gets the same 404. Check the "HTTP Method" field against what the sender uses. If you need several methods, the documented option is in the node Settings: turn on "Allow Multiple HTTP Methods", and the node gets one output per method.

Test it with curl, replacing the URL with yours:

bash
curl --request POST https://your-n8n.example.com/webhook/new-lead \
  --header 'Content-Type: application/json' \
  --data '{"email":"test@example.com"}'

Cause 4: the path changed

The path is the last part of the URL. If someone edited it, duplicated the workflow, or imported it on another instance, the old URL no longer exists. Copy the URL again from the node and update the sender. Set a readable custom path such as new-lead instead of the random default, so changes are deliberate.

Also check for conflicts: n8n allows only one webhook per path and method. If another published workflow already uses POST /new-lead, unpublish one or change its path.

Cause 5: the base URL is wrong (self-hosted)

If the URL shown in the node starts with http://localhost:5678 while your instance is reachable at https://n8n.yourdomain.com, external services cannot reach it at all. Behind a reverse proxy, n8n cannot guess its public address. Set it explicitly with N8N_WEBHOOK_URL (it replaces WEBHOOK_URL, deprecated from n8n 2.35.0) and restart. Details in our guide to n8n webhook URLs.

A quick test routine

  1. 1 Open the Webhook node, select Test URL, click "Listen for test event".
  2. 2 Send a request with curl or our free Webhook Payload Generator within 120 seconds.
  3. 3 Confirm the data appears in the node.
  4. 4 Switch the sender to the Production URL, publish the workflow, and send again.
  5. 5 Open Executions to confirm the production run.

If the status code is something other than 404, our HTTP Status Explainer tells you what each code means for an automation.

Worked example: moving a Stripe webhook from test to production

A common sequence, and where the 404 creeps in:

  1. 1 You build the workflow with the Test URL and click "Listen for test event".
  2. 2 In Stripe, you add an endpoint with the Test URL and send a test event. It works: the data appears in n8n.
  3. 3 Two days later, real payments arrive. Stripe reports failures with status 404.

Nothing broke. Stripe still calls /webhook-test/..., and n8n only listens there for 120 seconds after you click. The fix:

  1. 1 Open the Webhook node, switch to Production URL, copy it.
  2. 2 In Stripe, edit the endpoint and paste the Production URL.
  3. 3 Save and publish the workflow in n8n.
  4. 4 Use Stripe's "send test event" again, then open Executions in n8n to confirm the run.

Apply the same logic to Typeform, Calendly, Shopify, HubSpot and every other sender: the endpoint configured on their side must be the Production URL.

How to read the response the sender received

Most senders keep a delivery log. What you see there tells you where to look:

Response in the sender's logMeaningWhere to look
404, "The requested webhook ... is not registered"Nothing listening on that URL and methodURL type, publish state, method, path
403Allowlist or authentication rejected itWebhook auth settings, IP allowlist, proxy hops
200 "Workflow got started"It worked; the workflow rann8n Executions tab
500The workflow failed before respondingThe failed execution in n8n
Timeout, no statusNever reached n8nDNS, TLS, firewall, base URL

Duplicated workflows and imports

Duplicating a workflow or importing it on another instance copies the Webhook node with its path. Two outcomes:

  • On the same instance, the copy cannot be published with the same path and method as the original. n8n allows one webhook per path and method. Change the path in the copy.
  • On another instance, the path is the same but the base URL differs. Update the senders to the new domain.

Troubleshooting table

SituationFix
Works when you click "Listen", fails laterSender uses the Test URL; switch it to the Production URL
Production URL returns 404Publish the workflow; check the method and path
404 only for GET requestsNode set to POST; enable Allow Multiple HTTP Methods or change the sender
404 after editing the nodePath changed; update the sender
"path already in use" when publishingAnother published workflow uses the same path and method
URL shows localhostSet N8N_WEBHOOK_URL on self-hosted

Production checklist

  • External services configured with the Production URL.
  • Workflow published, and checked again after every edit.
  • Custom, readable path; no duplicate path and method on the instance.
  • Base URL showing your public https domain.

Frequently asked questions

Why does my n8n webhook work in test but not in production?

The sender is probably still calling the Test URL (/webhook-test/), or the workflow is not published. Use the Production URL (/webhook/) and publish the workflow.

How long does the n8n test webhook listen?

120 seconds after you click "Listen for test event".

Where do I see production webhook data in n8n?

In the workflow's Executions tab. Production runs are not displayed on the canvas.

Can two workflows use the same webhook path?

Not with the same HTTP method. n8n allows one webhook per path and method combination.

Do I need to republish after changing a webhook path?

Yes. Save and publish so the new path is registered, then update the sender.

Can the Test URL be used permanently?

No. It only listens for 120 seconds after "Listen for test event" and is meant for building and debugging.

Why does my webhook return 404 on n8n Cloud?

The same causes as self-hosted: Test URL not listening, unpublished workflow, or a method or path mismatch. Check the URL type first.

Tags

n8nwebhookerror404troubleshooting
Steve, founder of PURIST

Steve founded PURIST, a workflow automation studio working with n8n, Make and Claude AI, and is the point of contact on every project. Prices and features in our articles come from vendor documentation and public pricing pages. How we research and score tools.

Complete guide

Automation Tools & Platforms

11 min read n8n Code Node: 15 JavaScript Examples You Can Copy and … 8 min read n8n Code Node With Multiple Inputs: 3 Methods That Work 7 min read Fix "Cannot find module" in the n8n Code Node (npm Pack… 7 min read n8n Code Node Errors Fixed: "Code doesn't return items … 7 min read $env and Credentials in the n8n Code Node: What Works a… 7 min read n8n Code Node Binary Data: Read, Change and Return File… 7 min read Python in the n8n Code Node (n8n 2.x): Setup, Syntax an… 6 min read n8n Webhook URL: Test vs Production, and How to Change … 7 min read n8n Respond to Webhook: Return JSON, Status Codes, Redi… 8 min read Secure an n8n Webhook: Header Auth, Basic Auth, JWT and… 7 min read n8n Webhook Not Working? 10 Causes and How to Fix Each … 7 min read n8n HTTP Request Pagination: Every Pattern With Working… 7 min read n8n HTTP Request Authentication: API Keys, Bearer Token… 7 min read n8n HTTP Request Timeout and "Aborted" Errors: Causes a… 7 min read Upload and Download Files With the n8n HTTP Request Nod… 6 min read Fix ECONNREFUSED in n8n: Docker, localhost and 127.0.0.… 6 min read n8n 429 Too Many Requests: Batching, Retries and Rate L… 6 min read Fix redirect_uri_mismatch for n8n OAuth2 Credentials (G… 7 min read n8n Expression Errors Fixed: "Referenced node is unexec… 6 min read Anatomy Claude skill: what it is, how to install it, an… 5 min read How to explain a business process with the Anatomy skil… 5 min read Anatomy vs Mermaid vs Excalidraw: which to explain a wo… 14 min read n8n LinkedIn Job Automation: Auto-Apply, Track, and Fol… 16 min read n8n HTTP Request Node: Complete Documentation and Examp… 18 min read The future of automation: how our engineering team is s… 8 min read n8n vs Make vs Zapier: the honest comparison your busin… 11 min read n8n vs Make vs Zapier: an honest comparison for product… 7 min read Webhook vs polling: the architecture decision that dete… 24 min read n8n tutorial: build your first production workflow in u… 26 min read The 9 best Zapier alternatives in 2026: an honest ranki… 21 min read Make.com tutorial: build powerful automations without c… 19 min read Automation consultant vs DIY: how to decide what is rig… 14 min read n8n Self-Hosted vs Cloud: The Complete Decision Guide (… 15 min read 5 Zapier Free Alternatives That Handle Real Production … 15 min read WhatsApp Business Automation With n8n: Build a 24/7 Cus… 17 min read Google Workspace Automation: 15 Workflows for Sheets, D… 16 min read Claude AI for Business Automation: What It Does, What I… 15 min read Airtable Automation With n8n: 10 Workflows That Make Yo… 15 min read Droven.io AI Automation Tools: Full Review and Best Alt… 14 min read Droven.io RPA and Business Automation: An Honest 2026 R… 15 min read Enterprise Workflow Automation: The Complete Guide for … 13 min read Document Workflow Automation: Software, Implementation,… 14 min read Marketing Automation Workflow: From Content Creation to… 16 min read Ad Campaign Workflow Data Model and SDR Inbound Pipelin… 14 min read ComfyUI Workflows for Business: Product Photography, Ma… 13 min read GPT-5.2 for Business Workflows and the spec-workflow-mc… 17 min read ServiceNow vs IBM BAW vs n8n: Enterprise Workflow Autom… 16 min read 9 Best Workflow Automation Tools for Small Business in …

Keep reading

More from the blog.

All articles

From audit to deployment

Experience the automation
these articles are about.

Get my free automation plan →