From 491741be2305994a2a8deb776f84dea65ae96861 Mon Sep 17 00:00:00 2001
From: Dharun Ashokkumar <dharuna457@gmail.com>
Date: Tue, 20 Jan 2026 09:52:35 +0530
Subject: [PATCH 1/5] feat: add google sheets notification provider

logs monitor events to google spreadsheet via apps script webhook
---
 .../notification-providers/google-sheets.js   |  62 ++++++++++
 server/notification.js                        |   2 +
 src/components/NotificationDialog.vue         |   4 +-
 src/components/notifications/GoogleSheets.vue | 116 ++++++++++++++++++
 src/components/notifications/index.js         |   2 +
 5 files changed, 185 insertions(+), 1 deletion(-)
 create mode 100644 server/notification-providers/google-sheets.js
 create mode 100644 src/components/notifications/GoogleSheets.vue

diff --git a/server/notification-providers/google-sheets.js b/server/notification-providers/google-sheets.js
new file mode 100644
index 000000000..416c5ba8a
--- /dev/null
+++ b/server/notification-providers/google-sheets.js
@@ -0,0 +1,62 @@
+const NotificationProvider = require("./notification-provider");
+const axios = require("axios");
+const { DOWN, UP } = require("../../src/util");
+
+class GoogleSheets extends NotificationProvider {
+    name = "GoogleSheets";
+
+    /**
+     * @inheritdoc
+     */
+    async send(notification, msg, monitorJSON = null, heartbeatJSON = null) {
+        const okMsg = "Sent Successfully.";
+
+        try {
+            // Prepare the data to be logged
+            const timestamp = new Date().toISOString();
+            let status = "N/A";
+            let monitorName = "N/A";
+            let monitorUrl = "N/A";
+            let responseTime = "N/A";
+            let statusCode = "N/A";
+
+            if (monitorJSON) {
+                monitorName = monitorJSON.name || "N/A";
+                monitorUrl = this.extractAddress(monitorJSON) || "N/A";
+            }
+
+            if (heartbeatJSON) {
+                status = heartbeatJSON.status === DOWN ? "DOWN" : heartbeatJSON.status === UP ? "UP" : "UNKNOWN";
+                responseTime = heartbeatJSON.ping || "N/A";
+                statusCode = heartbeatJSON.status || "N/A";
+            }
+
+            // Send data to Google Apps Script webhook
+            const webhookUrl = notification.googleSheetsWebhookUrl;
+            
+            const config = this.getAxiosConfigWithProxy({
+                headers: {
+                    "Content-Type": "application/json"
+                }
+            });
+
+            const data = {
+                timestamp: timestamp,
+                status: status,
+                monitorName: monitorName,
+                monitorUrl: monitorUrl,
+                message: msg,
+                responseTime: responseTime,
+                statusCode: statusCode
+            };
+
+            await axios.post(webhookUrl, data, config);
+
+            return okMsg;
+        } catch (error) {
+            this.throwGeneralAxiosError(error);
+        }
+    }
+}
+
+module.exports = GoogleSheets;
diff --git a/server/notification.js b/server/notification.js
index de429388c..a1a6fec3c 100644
--- a/server/notification.js
+++ b/server/notification.js
@@ -17,6 +17,7 @@ const Feishu = require("./notification-providers/feishu");
 const Notifery = require("./notification-providers/notifery");
 const FreeMobile = require("./notification-providers/freemobile");
 const GoogleChat = require("./notification-providers/google-chat");
+const GoogleSheets = require("./notification-providers/google-sheets");
 const Gorush = require("./notification-providers/gorush");
 const Gotify = require("./notification-providers/gotify");
 const GrafanaOncall = require("./notification-providers/grafana-oncall");
@@ -117,6 +118,7 @@ class Notification {
             new Feishu(),
             new FreeMobile(),
             new GoogleChat(),
+            new GoogleSheets(),
             new Gorush(),
             new Gotify(),
             new GrafanaOncall(),
diff --git a/src/components/NotificationDialog.vue b/src/components/NotificationDialog.vue
index 6d915255a..1c8bd68cb 100644
--- a/src/components/NotificationDialog.vue
+++ b/src/components/NotificationDialog.vue
@@ -305,7 +305,9 @@ export default {
             };
 
             // Other Integrations
-            let other = {};
+            let other = {
+                GoogleSheets: "Google Sheets",
+            };
 
             // Regional - Not supported in most regions or documentation is not in English
             let regional = {
diff --git a/src/components/notifications/GoogleSheets.vue b/src/components/notifications/GoogleSheets.vue
new file mode 100644
index 000000000..1d21cbdeb
--- /dev/null
+++ b/src/components/notifications/GoogleSheets.vue
@@ -0,0 +1,116 @@
+<template>
+    <div class="mb-3">
+        <label for="google-sheets-webhook-url" class="form-label">{{ $t("Google Apps Script Webhook URL") }}</label>
+        <input
+            id="google-sheets-webhook-url"
+            v-model="$parent.notification.googleSheetsWebhookUrl"
+            type="text"
+            class="form-control"
+            required
+            placeholder="https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec"
+        />
+        <div class="form-text">
+            <p>{{ $t("Deploy a Google Apps Script as a web app and paste the URL here") }}</p>
+        </div>
+    </div>
+
+    <div class="alert alert-info" style="border-radius: 8px;">
+        <h6 style="margin-bottom: 12px; font-weight: 600;">{{ $t("Quick Setup Guide") }}:</h6>
+        <ol style="margin-bottom: 0; padding-left: 20px; line-height: 1.8;">
+            <li>{{ $t("Open your Google Spreadsheet") }}</li>
+            <li>{{ $t("Go to Extensions → Apps Script") }}</li>
+            <li>{{ $t("Paste the script code (see below)") }}</li>
+            <li>{{ $t("Click Deploy → New deployment → Web app") }}</li>
+            <li>{{ $t("Set 'Execute as: Me' and 'Who has access: Anyone'") }}</li>
+            <li>{{ $t("Copy the web app URL and paste it above") }}</li>
+        </ol>
+    </div>
+
+    <div class="mb-3">
+        <button 
+            type="button" 
+            class="btn btn-secondary btn-sm" 
+            @click="showScript = !showScript"
+        >
+            {{ showScript ? $t("Hide Script Code") : $t("Show Script Code") }}
+        </button>
+    </div>
+
+    <div v-if="showScript" class="mb-3">
+        <label class="form-label">{{ $t("Google Apps Script Code") }}:</label>
+        <textarea 
+            readonly 
+            class="form-control" 
+            rows="15" 
+            style="font-family: monospace; font-size: 12px;"
+        >function doPost(e) {
+  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
+  var data = JSON.parse(e.postData.contents);
+  
+  // Add header row if sheet is empty
+  if (sheet.getLastRow() === 0) {
+    sheet.appendRow(['Timestamp', 'Status', 'Monitor Name', 'URL', 'Message', 'Response Time', 'Status Code']);
+  }
+  
+  // Add data row
+  sheet.appendRow([
+    data.timestamp,
+    data.status,
+    data.monitorName,
+    data.monitorUrl,
+    data.message,
+    data.responseTime,
+    data.statusCode
+  ]);
+  
+  return ContentService.createTextOutput(JSON.stringify({result: 'success'}))
+    .setMimeType(ContentService.MimeType.JSON);
+}</textarea>
+        <button 
+            type="button" 
+            class="btn btn-outline-secondary btn-sm mt-2" 
+            @click="copyScript"
+        >
+            {{ $t("Copy to Clipboard") }}
+        </button>
+    </div>
+</template>
+
+<script>
+export default {
+    data() {
+        return {
+            showScript: false
+        };
+    },
+    methods: {
+        copyScript() {
+            const scriptCode = `function doPost(e) {
+  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
+  var data = JSON.parse(e.postData.contents);
+  
+  // Add header row if sheet is empty
+  if (sheet.getLastRow() === 0) {
+    sheet.appendRow(['Timestamp', 'Status', 'Monitor Name', 'URL', 'Message', 'Response Time', 'Status Code']);
+  }
+  
+  // Add data row
+  sheet.appendRow([
+    data.timestamp,
+    data.status,
+    data.monitorName,
+    data.monitorUrl,
+    data.message,
+    data.responseTime,
+    data.statusCode
+  ]);
+  
+  return ContentService.createTextOutput(JSON.stringify({result: 'success'}))
+    .setMimeType(ContentService.MimeType.JSON);
+}`;
+            navigator.clipboard.writeText(scriptCode);
+            alert(this.$t("Copied to clipboard!"));
+        }
+    }
+};
+</script>
diff --git a/src/components/notifications/index.js b/src/components/notifications/index.js
index 1a8f6dba3..6a7c3e71b 100644
--- a/src/components/notifications/index.js
+++ b/src/components/notifications/index.js
@@ -15,6 +15,7 @@ import Elks from "./46elks.vue";
 import Feishu from "./Feishu.vue";
 import FreeMobile from "./FreeMobile.vue";
 import GoogleChat from "./GoogleChat.vue";
+import GoogleSheets from "./GoogleSheets.vue";
 import Gorush from "./Gorush.vue";
 import Gotify from "./Gotify.vue";
 import GrafanaOncall from "./GrafanaOncall.vue";
@@ -105,6 +106,7 @@ const NotificationFormList = {
     Feishu: Feishu,
     FreeMobile: FreeMobile,
     GoogleChat: GoogleChat,
+    GoogleSheets: GoogleSheets,
     gorush: Gorush,
     gotify: Gotify,
     GrafanaOncall: GrafanaOncall,

From 44923b01415b633642fc51d62b5e6afedcdddd69 Mon Sep 17 00:00:00 2001
From: Dharun Ashokkumar <dharuna457@gmail.com>
Date: Tue, 20 Jan 2026 10:02:20 +0530
Subject: [PATCH 2/5] fix: address copilot review suggestions

use proper statusCode field and add error handling for clipboard
---
 server/notification-providers/google-sheets.js | 14 +++++++-------
 src/components/notifications/GoogleSheets.vue  |  8 ++++++--
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/server/notification-providers/google-sheets.js b/server/notification-providers/google-sheets.js
index 416c5ba8a..8c8ec1581 100644
--- a/server/notification-providers/google-sheets.js
+++ b/server/notification-providers/google-sheets.js
@@ -28,7 +28,7 @@ class GoogleSheets extends NotificationProvider {
             if (heartbeatJSON) {
                 status = heartbeatJSON.status === DOWN ? "DOWN" : heartbeatJSON.status === UP ? "UP" : "UNKNOWN";
                 responseTime = heartbeatJSON.ping || "N/A";
-                statusCode = heartbeatJSON.status || "N/A";
+                statusCode = heartbeatJSON.statusCode || "N/A";
             }
 
             // Send data to Google Apps Script webhook
@@ -41,13 +41,13 @@ class GoogleSheets extends NotificationProvider {
             });
 
             const data = {
-                timestamp: timestamp,
-                status: status,
-                monitorName: monitorName,
-                monitorUrl: monitorUrl,
+                timestamp,
+                status,
+                monitorName,
+                monitorUrl,
                 message: msg,
-                responseTime: responseTime,
-                statusCode: statusCode
+                responseTime,
+                statusCode
             };
 
             await axios.post(webhookUrl, data, config);
diff --git a/src/components/notifications/GoogleSheets.vue b/src/components/notifications/GoogleSheets.vue
index 1d21cbdeb..2f167b3ce 100644
--- a/src/components/notifications/GoogleSheets.vue
+++ b/src/components/notifications/GoogleSheets.vue
@@ -108,8 +108,12 @@ export default {
   return ContentService.createTextOutput(JSON.stringify({result: 'success'}))
     .setMimeType(ContentService.MimeType.JSON);
 }`;
-            navigator.clipboard.writeText(scriptCode);
-            alert(this.$t("Copied to clipboard!"));
+            try {
+                navigator.clipboard.writeText(scriptCode);
+                alert(this.$t("Copied to clipboard!"));
+            } catch (error) {
+                alert(this.$t("Failed to copy to clipboard"));
+            }
         }
     }
 };

From bcaf554896a92f43cc2245d6f7320c6292bdd91b Mon Sep 17 00:00:00 2001
From: Dharun Ashokkumar <dharuna457@gmail.com>
Date: Tue, 20 Jan 2026 21:17:58 +0530
Subject: [PATCH 3/5] fix: address code review feedback

Use HiddenInput for webhook URL, replace button with ToggleSection, inline webhook variable, and move script to constant to avoid duplication
---
 .../notification-providers/google-sheets.js   |   4 +-
 src/components/notifications/GoogleSheets.vue | 102 +++++++-----------
 2 files changed, 41 insertions(+), 65 deletions(-)

diff --git a/server/notification-providers/google-sheets.js b/server/notification-providers/google-sheets.js
index 8c8ec1581..fc74a6b55 100644
--- a/server/notification-providers/google-sheets.js
+++ b/server/notification-providers/google-sheets.js
@@ -32,8 +32,6 @@ class GoogleSheets extends NotificationProvider {
             }
 
             // Send data to Google Apps Script webhook
-            const webhookUrl = notification.googleSheetsWebhookUrl;
-            
             const config = this.getAxiosConfigWithProxy({
                 headers: {
                     "Content-Type": "application/json"
@@ -50,7 +48,7 @@ class GoogleSheets extends NotificationProvider {
                 statusCode
             };
 
-            await axios.post(webhookUrl, data, config);
+            await axios.post(notification.googleSheetsWebhookUrl, data, config);
 
             return okMsg;
         } catch (error) {
diff --git a/src/components/notifications/GoogleSheets.vue b/src/components/notifications/GoogleSheets.vue
index 2f167b3ce..f702a94b4 100644
--- a/src/components/notifications/GoogleSheets.vue
+++ b/src/components/notifications/GoogleSheets.vue
@@ -1,13 +1,12 @@
 <template>
     <div class="mb-3">
         <label for="google-sheets-webhook-url" class="form-label">{{ $t("Google Apps Script Webhook URL") }}</label>
-        <input
+        <HiddenInput
             id="google-sheets-webhook-url"
             v-model="$parent.notification.googleSheetsWebhookUrl"
-            type="text"
-            class="form-control"
-            required
+            :required="true"
             placeholder="https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec"
+            autocomplete="off"
         />
         <div class="form-text">
             <p>{{ $t("Deploy a Google Apps Script as a web app and paste the URL here") }}</p>
@@ -26,66 +25,32 @@
         </ol>
     </div>
 
-    <div class="mb-3">
-        <button 
-            type="button" 
-            class="btn btn-secondary btn-sm" 
-            @click="showScript = !showScript"
-        >
-            {{ showScript ? $t("Hide Script Code") : $t("Show Script Code") }}
-        </button>
-    </div>
-
-    <div v-if="showScript" class="mb-3">
-        <label class="form-label">{{ $t("Google Apps Script Code") }}:</label>
-        <textarea 
-            readonly 
-            class="form-control" 
-            rows="15" 
-            style="font-family: monospace; font-size: 12px;"
-        >function doPost(e) {
-  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
-  var data = JSON.parse(e.postData.contents);
-  
-  // Add header row if sheet is empty
-  if (sheet.getLastRow() === 0) {
-    sheet.appendRow(['Timestamp', 'Status', 'Monitor Name', 'URL', 'Message', 'Response Time', 'Status Code']);
-  }
-  
-  // Add data row
-  sheet.appendRow([
-    data.timestamp,
-    data.status,
-    data.monitorName,
-    data.monitorUrl,
-    data.message,
-    data.responseTime,
-    data.statusCode
-  ]);
-  
-  return ContentService.createTextOutput(JSON.stringify({result: 'success'}))
-    .setMimeType(ContentService.MimeType.JSON);
-}</textarea>
-        <button 
-            type="button" 
-            class="btn btn-outline-secondary btn-sm mt-2" 
-            @click="copyScript"
-        >
-            {{ $t("Copy to Clipboard") }}
-        </button>
-    </div>
+    <ToggleSection :heading="$t('Google Apps Script Code')">
+        <div class="mb-3">
+            <textarea 
+                readonly 
+                class="form-control" 
+                rows="15" 
+                style="font-family: monospace; font-size: 12px;"
+                :value="scriptCode"
+            />
+            <button 
+                type="button" 
+                class="btn btn-outline-secondary btn-sm mt-2" 
+                @click="copyScript"
+            >
+                {{ $t("Copy to Clipboard") }}
+            </button>
+        </div>
+    </ToggleSection>
 </template>
 
 <script>
-export default {
-    data() {
-        return {
-            showScript: false
-        };
-    },
-    methods: {
-        copyScript() {
-            const scriptCode = `function doPost(e) {
+import HiddenInput from "../HiddenInput.vue";
+import ToggleSection from "../ToggleSection.vue";
+
+// Google Apps Script code for logging to spreadsheet
+const GOOGLE_APPS_SCRIPT_CODE = `function doPost(e) {
   var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
   var data = JSON.parse(e.postData.contents);
   
@@ -108,8 +73,21 @@ export default {
   return ContentService.createTextOutput(JSON.stringify({result: 'success'}))
     .setMimeType(ContentService.MimeType.JSON);
 }`;
+
+export default {
+    components: {
+        HiddenInput,
+        ToggleSection,
+    },
+    computed: {
+        scriptCode() {
+            return GOOGLE_APPS_SCRIPT_CODE;
+        }
+    },
+    methods: {
+        copyScript() {
             try {
-                navigator.clipboard.writeText(scriptCode);
+                navigator.clipboard.writeText(GOOGLE_APPS_SCRIPT_CODE);
                 alert(this.$t("Copied to clipboard!"));
             } catch (error) {
                 alert(this.$t("Failed to copy to clipboard"));

From 32c2b912e651b1278854111463ed053adf74be42 Mon Sep 17 00:00:00 2001
From: Dharun Ashokkumar <dharuna457@gmail.com>
Date: Tue, 20 Jan 2026 21:33:01 +0530
Subject: [PATCH 4/5] fix: add missing translation keys

Add English translations for Google Sheets notification setup instructions
---
 src/lang/en.json | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/lang/en.json b/src/lang/en.json
index a2a87669d..39d24bc26 100644
--- a/src/lang/en.json
+++ b/src/lang/en.json
@@ -733,6 +733,19 @@
     "pushyToken": "Device token",
     "apprise": "Apprise (Support 50+ Notification services)",
     "GoogleChat": "Google Chat (Google Workspace only)",
+    "Google Apps Script Webhook URL": "Google Apps Script Webhook URL",
+    "Deploy a Google Apps Script as a web app and paste the URL here": "Deploy a Google Apps Script as a web app and paste the URL here",
+    "Quick Setup Guide": "Quick Setup Guide",
+    "Open your Google Spreadsheet": "Open your Google Spreadsheet",
+    "Go to Extensions → Apps Script": "Go to Extensions → Apps Script",
+    "Paste the script code (see below)": "Paste the script code (see below)",
+    "Click Deploy → New deployment → Web app": "Click Deploy → New deployment → Web app",
+    "Set 'Execute as: Me' and 'Who has access: Anyone'": "Set 'Execute as: Me' and 'Who has access: Anyone'",
+    "Copy the web app URL and paste it above": "Copy the web app URL and paste it above",
+    "Google Apps Script Code": "Google Apps Script Code",
+    "Copy to Clipboard": "Copy to Clipboard",
+    "Copied to clipboard!": "Copied to clipboard!",
+    "Failed to copy to clipboard": "Failed to copy to clipboard",
     "Template plain text instead of using cards": "Template plain text instead of using cards",
     "issueWithGoogleChatOnAndroidHelptext": "This also allows to get around bugs upstream like {issuetackerURL}",
     "wayToGetKookBotToken": "Create application and get your bot token at {0}",

From 0645d0ad105458069189a6ef150cbd235bfcd4c3 Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:04:51 +0000
Subject: [PATCH 5/5] [autofix.ci] apply automated fixes

---
 .../notification-providers/google-sheets.js   |  6 ++--
 src/components/notifications/GoogleSheets.vue | 28 ++++++++-----------
 2 files changed, 15 insertions(+), 19 deletions(-)

diff --git a/server/notification-providers/google-sheets.js b/server/notification-providers/google-sheets.js
index fc74a6b55..6220e272f 100644
--- a/server/notification-providers/google-sheets.js
+++ b/server/notification-providers/google-sheets.js
@@ -34,8 +34,8 @@ class GoogleSheets extends NotificationProvider {
             // Send data to Google Apps Script webhook
             const config = this.getAxiosConfigWithProxy({
                 headers: {
-                    "Content-Type": "application/json"
-                }
+                    "Content-Type": "application/json",
+                },
             });
 
             const data = {
@@ -45,7 +45,7 @@ class GoogleSheets extends NotificationProvider {
                 monitorUrl,
                 message: msg,
                 responseTime,
-                statusCode
+                statusCode,
             };
 
             await axios.post(notification.googleSheetsWebhookUrl, data, config);
diff --git a/src/components/notifications/GoogleSheets.vue b/src/components/notifications/GoogleSheets.vue
index f702a94b4..261cc4c5a 100644
--- a/src/components/notifications/GoogleSheets.vue
+++ b/src/components/notifications/GoogleSheets.vue
@@ -13,9 +13,9 @@
         </div>
     </div>
 
-    <div class="alert alert-info" style="border-radius: 8px;">
-        <h6 style="margin-bottom: 12px; font-weight: 600;">{{ $t("Quick Setup Guide") }}:</h6>
-        <ol style="margin-bottom: 0; padding-left: 20px; line-height: 1.8;">
+    <div class="alert alert-info" style="border-radius: 8px">
+        <h6 style="margin-bottom: 12px; font-weight: 600">{{ $t("Quick Setup Guide") }}:</h6>
+        <ol style="margin-bottom: 0; padding-left: 20px; line-height: 1.8">
             <li>{{ $t("Open your Google Spreadsheet") }}</li>
             <li>{{ $t("Go to Extensions → Apps Script") }}</li>
             <li>{{ $t("Paste the script code (see below)") }}</li>
@@ -27,18 +27,14 @@
 
     <ToggleSection :heading="$t('Google Apps Script Code')">
         <div class="mb-3">
-            <textarea 
-                readonly 
-                class="form-control" 
-                rows="15" 
-                style="font-family: monospace; font-size: 12px;"
+            <textarea
+                readonly
+                class="form-control"
+                rows="15"
+                style="font-family: monospace; font-size: 12px"
                 :value="scriptCode"
             />
-            <button 
-                type="button" 
-                class="btn btn-outline-secondary btn-sm mt-2" 
-                @click="copyScript"
-            >
+            <button type="button" class="btn btn-outline-secondary btn-sm mt-2" @click="copyScript">
                 {{ $t("Copy to Clipboard") }}
             </button>
         </div>
@@ -82,7 +78,7 @@ export default {
     computed: {
         scriptCode() {
             return GOOGLE_APPS_SCRIPT_CODE;
-        }
+        },
     },
     methods: {
         copyScript() {
@@ -92,7 +88,7 @@ export default {
             } catch (error) {
                 alert(this.$t("Failed to copy to clipboard"));
             }
-        }
-    }
+        },
+    },
 };
 </script>