GitHub Issue Automation Workflow

This n8n workflow provides a basic framework for automating actions related to GitHub issues. It listens for GitHub events and includes conditional logic to process them. While the current implementation is a starting point, it's designed to be easily extended for various GitHub automation tasks, such as assigning issues, sending notifications, or updating other systems.

What it does

This workflow currently defines the following steps:

1. Listens for GitHub Events: It acts as a webhook listener for events occurring within a GitHub repository.
2. Initial Conditional Check: It uses an "If" node to evaluate incoming GitHub events, allowing for branching logic based on event properties.
3. Further Conditional Routing: A "Switch" node is included after the initial check, providing more granular routing options based on different conditions or event types.
4. Placeholder for Actions: A "No Operation" node serves as a placeholder for where actual automation logic would be implemented based on the conditions met.

Prerequisites/Requirements

• n8n Instance: A running n8n instance.
• GitHub Account: Access to a GitHub account and a repository where you want to monitor events.
• GitHub Credential in n8n: You will need to set up a GitHub OAuth or Access Token credential within n8n to connect to your GitHub account.

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.
2. Configure GitHub Trigger:
   • Click on the "Github Trigger" node.
   • Select your GitHub credential. If you don't have one, click "Create New" and follow the instructions to connect your GitHub account (usually via OAuth or Personal Access Token).
   • Specify the "Repository" and the "Events" you want to listen for (e.g., Issues, Issue Comment).
   • Important: After configuring, save the workflow and then click "Activate" on the "Github Trigger" node to generate the webhook URL. You will need to add this URL as a webhook in your GitHub repository settings.
3. Configure Conditional Logic (If and Switch Nodes):
   • The "If" and "Switch" nodes are currently generic. You will need to configure their conditions based on the specific GitHub event data you want to filter or route.
     • If Node: Edit the conditions to check for specific properties from the GitHub event payload (e.g., {{ $json.action === "opened" }} to check if an issue was opened).
     • Switch Node: Add cases to handle different values or conditions based on the output of the previous nodes.
4. Implement Automation Logic:
   • Replace or connect nodes to the "No Operation, do nothing" node (or its branches) with the actual actions you want to perform. For example:
     • Use the "GitHub" node to assign an issue, add labels, or post comments.
     • Use a "Slack" node to send notifications.
     • Use a "Google Sheets" node to log issue details.
     • Use an "HTTP Request" node to interact with other APIs.
5. Activate the Workflow: Once configured, activate the workflow to start listening for GitHub events and executing your defined automation.