Public Webhook Relay for Local n8n Development
detail.loadingPreview
This n8n workflow provides a secure and efficient way to relay public webhook requests from external services to your local n8n instance. It's an indispensable tool for developing and testing webhook-driven automations without exposing your local environment directly to the internet.
About This Workflow
Developing n8n workflows that rely on external webhooks can be challenging when working locally, often requiring tunneling services or complex network configurations. This 'Public Webhook Relay' workflow elegantly solves this by leveraging webhook.site as a temporary, public endpoint. It periodically polls webhook.site for new incoming requests, intelligently filters them based on method and timestamp, and then forwards only the unprocessed POST requests directly to your local n8n webhook address. This allows for seamless local development, testing, and debugging of integrations that require public-facing webhooks, keeping your local machine secure and isolated behind your firewall.
Key Features
- Temporary Public Endpoint: Automatically creates and manages a temporary, unique public webhook URL via
webhook.site. - Intelligent Polling: Periodically checks for new requests, ensuring only fresh, unprocessed data is relayed to avoid redundant executions.
- Request Filtering: Filters incoming requests by method (defaulting to POST) and ensures only requests newer than the last processed one are forwarded.
- Local n8n Integration: Seamlessly forwards filtered requests as JSON to your specified local n8n webhook address.
- Stateful Operation: Utilizes a Key-Value Storage node to persist the
webhook.siteauthentication token between workflow runs, maintaining a consistent public endpoint.
How To Use
- Install Key-Value Store (Prerequisite): If not already installed, go to
Settings>Community Nodesand enter@horka.tv/n8n-nodes-storage-kvto install the required Key-Value Store node. - Configure Schedule Trigger: Set the
Schedule Triggernode to your desired polling interval (e.g., every 10 seconds is the default). - Set Local Webhook Address: Update the
Local Webhook Addressnode with the exact URL of your local n8n workflow's webhook trigger. - Activate Workflow: Set the workflow to Active in n8n to begin processing.
- Retrieve Auth Token: After the workflow executes at least once, check the input to the
Get Latest Requestsnode for your uniquewebhook.siteauthentication token. - Send Test Request: Use
curlor a similar tool to send aPOSTrequest to yourwebhook.siteURL (e.g.,curl -X POST -H "Content-Type: application/json" -d '{"foo":"bar"}' https://webhook.site/[YOUR_AUTH_TOKEN]) - Verify Execution: Confirm that the workflow runs to completion in n8n's
Executionstab, and your local n8n workflow receives the forwarded data.
Apps Used
Workflow JSON
{
"id": "1e757e4c-73eb-46b8-bc7c-67997c3acb19",
"name": "Public Webhook Relay for Local n8n Development",
"nodes": 19,
"category": "DevOps",
"status": "active",
"version": "1.0.0"
}Note: This is a sample preview. The full workflow JSON contains node configurations, credentials placeholders, and execution logic.
Get This Workflow
ID: 1e757e4c-73eb...
About the Author
DevOps_Master_X
Infrastructure Expert
Specializing in CI/CD pipelines, Docker, and Kubernetes automations.
Statistics
Related Workflows
Discover more workflows you might like
Visualize Your n8n Workflows: Interactive Dashboard with Mermaid.js
Gain unparalleled visibility into your n8n automation landscape. This workflow transforms your n8n instance into a dynamic, interactive dashboard, leveraging Mermaid.js to visualize all your workflows in one accessible place.
Automated PR Merged QA Notifications
Streamline your QA process with this automated workflow that notifies your team upon successful Pull Request merges. Leverage AI and vector stores to enrich notifications and ensure seamless integration into your development pipeline.
Effortless Bug Reporting: Slack Slash Command to Linear Issue
Streamline your bug reporting process by instantly creating Linear issues directly from Slack using a simple slash command. This workflow enhances team collaboration by providing immediate feedback and a structured approach to logging defects, saving valuable time for development and QA teams.