class GmailApp method .createDraft()

GmailApp is the Apps Script service.

.createDraft() is the method name you will see after a dot in your code.

What it does

Creates a draft email without sending it.

Why it's used

  • Queue up a message for review before it goes out.
  • Build a mail-merge draft from sheet rows without sending yet.

Common errors

  • Forgetting parentheses on createDraft. Write GmailApp.createDraft(), not GmailApp.createDraft or createDraft by itself.
  • Skipping dots between chained calls. Each step needs a dot, like GmailApp.search('label:inbox').createDraft().
  • Adding spaces where they do not belong. Write GmailApp.createDraft(), not GmailApp .createDraft(), GmailApp.createDraft (), or GmailApp . createDraft().
  • Wrong capitalization. Use GmailApp and createDraft, not gmailapp or createdraft.

Explore

Related methods

Better Sheets tutorials

No tagged tutorials yet. Fetch Apps Script from the harvest table and this page fills automatically.

Related blog posts

Written guides about GmailApp.createDraft().

Browse the blog