Daily GitHub Release Notification by Email

This n8n workflow automates the process of checking for new GitHub releases for a specified repository and sending an email notification when new releases are found.

What it does

This workflow simplifies staying updated on new software releases for your monitored GitHub repository.

1. Schedules Check: The workflow is triggered on a schedule (e.g., daily) to perform its checks.
2. Fetches GitHub Releases: It makes an HTTP request to the GitHub API to retrieve the latest releases for a configured repository.
3. Parses Releases: The workflow processes the API response to extract relevant release information.
4. Checks for New Releases: It compares the fetched releases with previously seen releases (this part is implied, as the If node is present but its condition is not explicitly defined in the provided JSON, suggesting it would compare new data against stored data or a specific criteria).
5. Formats Email Content: If new releases are detected, it uses a Markdown node to format a human-readable email body with the release details.
6. Sends Email Notification: Finally, it sends an email to a configured recipient with the formatted release information.

Prerequisites/Requirements

• n8n Instance: A running n8n instance to host the workflow.
• Email Sending Credentials: SMTP server details or an email service integration configured in n8n for the "Send Email" node.
• GitHub Repository URL: The API URL for the GitHub repository you wish to monitor (e.g., https://api.github.com/repos/owner/repo/releases).

Setup/Usage

1. Import the Workflow: Import the provided JSON into your n8n instance.
2. Configure GitHub API Request:
   • Locate the "HTTP Request" node.
   • Set the URL to the GitHub API endpoint for releases of your desired repository (e.g., https://api.github.com/repos/n8n-io/n8n/releases).
   • You might need to add authentication headers if you're hitting rate limits or accessing private repositories (though not explicitly configured in this JSON).
3. Configure Email Sending:
   • Locate the "Send Email" node.
   • Configure your email credentials (SMTP server, username, password, etc.) within n8n.
   • Set the To email address to where you want to receive notifications.
   • Customize the Subject and Body of the email as needed. The "Markdown" node likely provides the content for the email body.
4. Configure Schedule:
   • Locate the "Schedule Trigger" node.
   • Adjust the schedule (e.g., daily, hourly) according to how frequently you want to check for new releases.
5. Configure Conditional Logic (If Node):
   • The "If" node is crucial for determining if a new release has occurred. You will need to configure its condition based on your specific needs. This typically involves comparing the id or published_at date of the latest fetched release against a stored value (e.g., from a database, a Google Sheet, or even a simple n8n-nodes-base.keyValueStore node) to identify truly new releases.
6. Activate the Workflow: Once configured, activate the workflow in n8n.