n8n The requested webhook ... is not registered fix#

The exact error often looks like this:

The requested webhook "POST ..." is not registered.
The workflow must be active for a production URL to run successfully.

If the test URL works and the production URL fails, the problem is usually not your JSON body. The root cause is almost always one of these:

1. you are calling the test URL when you mean production
2. the workflow is not actually active
3. you expect production requests to appear on the canvas instead of in Executions

The key distinction: n8n has two webhook URLs#

The n8n webhook docs are explicit:

• Test URL: registered when you click Listen for Test Event or Execute workflow if the workflow is not active
• Production URL: registered when you publish the workflow

That means a successful test call proves only that the test endpoint is alive. It does not prove the production endpoint is registered.

The fix checklist#

1. Confirm you are sending to the right URL#

If you are still developing the workflow manually, use the test URL.

If an external system should call the workflow automatically, use the production URL.

Do not swap them mid-debugging and assume the behavior should match.

2. Activate the workflow#

The GitHub issue reports match what the UI hint says: production URLs need an active workflow.

If you call a production webhook on an inactive workflow, the request is not registered to a live route.

3. Check the Executions tab, not the canvas#

This trips people up constantly. The docs say production webhook data is not displayed on the canvas the way test events are. You inspect those runs from the Executions tab instead.

So if your webhook fires and the canvas looks idle, that does not automatically mean nothing happened.

The most common local-dev confusion#

This sequence produces the error every time:

1. Click Listen for Test Event
2. Verify /webhook-test/... works
3. Copy the production URL into the external service
4. Forget to activate the workflow
5. Get The requested webhook ... is not registered

That is not an n8n parsing bug. It is the expected lifecycle.

What to do if the workflow is active and it still fails#

At that point, recent GitHub issues are worth checking before you blame your payload or headers.

There are real reports from 2025 where API-based deployment or activation failed to register the production webhook path correctly. If you are activating workflows programmatically and the docs-correct steps still do not work, inspect your deployment flow and compare it against issue #21614.

I would debug in this order:

1. activate manually in the UI once
2. retry the production URL
3. inspect the Executions tab
4. if you automate deployment, compare your setup with the recent GitHub issue

A practical team rule#

Treat test and production URLs as different products:

• test URL for manual development
• production URL for real integrations

When you keep that boundary clear, this whole class of webhook confusion almost disappears.

For more n8n production work:

• n8n Complete Beginner Guide 2026: Build Your First Automation Workflow
• How I Fixed My n8n Workflow That Was Failing Silently for Three Weeks
• How I Built a Client Reporting System That Runs Itself (With n8n)
• How I Migrated from Zapier to n8n and Cut My Automation Bill to Zero

References#

• n8n docs: Webhook node
• GitHub issue #21614: workflow must be active for a production URL
• GitHub issue #15666: production webhook not registered, test webhook works