Get Email Notifications for Edits in Google Spreadsheet

A client wants to receive email notifications as soon as someone edits a Google Spreadsheet that is shared with a team of people. Google Docs supports the onEdit() trigger that runs whenever an edit is made to any cell of the sheet but a limitation is that the onEdit trigger cannot send emails. Nor can be used to call external API though the URLFetch service.

As a workaround, the edits were stored as a Property and another time-based trigger would periodically send the stored value by email.

/**
 * @OnlyCurrentDoc
 */

function onEdit(e) {

    var key = "ROWCHANGES";

    var range = e.range;

    var date = Utilities.formatDate(new Date(), e.source.getSpreadsheetTimeZone(), "dd-MM-yy HH:MM:s");

    var properties = PropertiesService.getUserProperties();

    var sheet = e.source.getActiveSheet();

    var data = sheet.getRange(range.getRow(), 1, 1, sheet.getLastColumn()).getValues()[0];

    data[range.getColumn() - 1] = "<b>" + data[range.getColumn() - 1] + "</b>";

    var edits = {
        name: sheet.getSheetName(),
        data: data
    };

    var existing = JSON.parse(properties.getProperty(key)) || {};

    existing[date] = edits;

    properties.setProperty(key, JSON.stringify(existing));

}

function onEdit_Email() {

    var properties = PropertiesService.getUserProperties();

    var json = JSON.parse(properties.getProperty("ROWCHANGES"));

    var html = "":

        for (var keys in json) {

            html = html + "<br>[" + keys + "][" + json[keys].name + "] &mdash; " + json[keys].data;

        }

    if (html !== "") {

        MailApp.sendEmail(email, subject, "", {
            htmlBody: html
        });

        properties.deleteAllProperties();

    }

}
Amit Agarwal

Amit Agarwal

Google Developer Expert, Google Cloud Champion

Amit Agarwal is a Google Developer Expert in Google Workspace and Google Apps Script. He holds an engineering degree in Computer Science (I.I.T.) and is the first professional blogger in India.

Amit has developed several popular Google add-ons including Mail Merge for Gmail and Document Studio. Read more on Lifehacker and YourStory

Awards & Titles

Digital Inspiration has won several awards since it's launch in 2004.

Google Developer Expert

Google Developer Expert

Google awarded us the Google Developer Expert award recogizing our work in Google Workspace.

ProductHunt Golden Kitty

ProductHunt Golden Kitty

Our Gmail tool won the Lifehack of the Year award at ProductHunt Golden Kitty Awards in 2017.

Microsoft MVP Alumni

Microsoft MVP Alumni

Microsoft awarded us the Most Valuable Professional (MVP) title for 5 years in a row.

Google Cloud Champion

Google Cloud Champion

Google awarded us the Champion Innovator title recognizing our technical skill and expertise.

Email Newsletter

Sign up for our email newsletter to stay up to date.

We will never send any spam emails. Promise.