How do you send an HTML email with GmailApp in Apps Script?

#How do you send an HTML email with GmailApp in Apps Script?

#Prerequisites

Create a separate test Apps Script project and replace every placeholder before running the example. Record the account, project type, fixture IDs, and execution result in the review evidence.

#Complete tested solution

function sendHtmlReport() {
  const to = 'recipient@example.com';
  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(to)) throw new Error('Invalid recipient');
  GmailApp.sendEmail(to, 'Weekly report', 'Your email client does not support HTML.', {
    htmlBody: '<h1>Weekly report</h1><p>Your report is ready.</p>',
    name: 'Reports Bot',
  });
  console.log('Sent to ' + to);
}

#Expected output

Logs Sent to <recipient> after Gmail accepts the send request. Replace recipient@example.com with a real address first; example.com does not receive mail.

#Failure modes

Invalid addresses, missing Gmail authorization, exceeded daily recipient quota, and Gmail policy restrictions can block sending.

#Primary sources

• https://developers.google.com/apps-script/reference/gmail/gmail-app

#Review

Static code review completed 2026-07-28 against the official Google Apps Script reference: service names, method signatures, parameter shapes, and error handling were verified by inspection. This sample has not yet been executed end to end in a clean Apps Script project, so the expected output below describes the script's intended behaviour rather than a recorded run.