n8n Workflow: Basic Webhook Listener with Conditional Logic

This n8n workflow provides a foundational structure for receiving data via a webhook, applying conditional logic, and responding to the incoming request. It demonstrates how to set up an entry point for external systems and process the data based on specific criteria.

What it does

This workflow simplifies the process of:

1. Receiving Webhook Data: It starts by listening for incoming HTTP requests at a defined webhook URL.
2. Applying Conditional Logic: It evaluates the received data using a "Switch" node, allowing for different processing paths based on the value of a specific field (e.g., body.action).
3. Data Transformation (Optional): A "Set" node is included, demonstrating how to modify or add fields to the incoming data.
4. SSH Command Execution (Optional): An SSH node is present, indicating the potential to execute remote commands based on the workflow's logic.
5. Custom Code Execution (Optional): A "Code" node is available for executing custom JavaScript logic.
6. Responding to the Webhook: It concludes by sending a response back to the system that initiated the webhook request.

Prerequisites/Requirements

• n8n Instance: A running n8n instance (self-hosted or cloud).
• Webhook Source: An external system or application configured to send HTTP POST requests to the n8n webhook URL.
• SSH Credentials (if using SSH node): If the SSH node is to be used, appropriate SSH credentials configured in n8n.

Setup/Usage

1. Import the Workflow:
   • Copy the provided JSON code.
   • In your n8n instance, go to "Workflows" and click "New".
   • Click the "Import from JSON" button and paste the copied JSON.
   • Click "Import".
2. Configure the Webhook Trigger:
   • The "Webhook" node (ID: 47) is already configured to listen for POST requests.
   • Activate the workflow to generate the unique webhook URL. You can find this URL in the "Webhook" node's settings once the workflow is active.
   • Configure your external system to send data to this URL.
3. Customize Conditional Logic:
   • The "Switch" node (ID: 112) currently has no conditions defined. Click on it and add conditions based on the data you expect from your webhook. For example, you might check {{ $json.body.action }} for values like "deploy", "update", or "delete".
4. Customize Data Transformation:
   • The "Edit Fields (Set)" node (ID: 38) is currently empty. You can use it to add, remove, or modify fields in the incoming data before further processing.
5. Configure SSH Commands (if needed):
   • The "SSH" node (ID: 490) is present but not connected. If you intend to execute SSH commands, connect it to the appropriate branch of your "Switch" node and configure the SSH credentials and commands to run.
6. Add Custom Code (if needed):
   • The "Code" node (ID: 834) is present but not connected. If you need to execute custom JavaScript logic, connect it to the appropriate branch and write your code.
7. Configure Webhook Response:
   • The "Respond to Webhook" node (ID: 535) is ready to send a response. You can customize the response body and HTTP status code as needed.
8. Activate the Workflow: Once configured, activate the workflow to start listening for incoming webhook requests.

This workflow serves as a flexible template for building more complex automation tasks triggered by external events.