Creates a draft email without sending it.
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
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
-
.sendEmail()
Sends an email from the user's Gmail account.
-
.createLabel()
Creates a new Gmail label.
-
.search()
Finds Gmail threads that match a search query.
-
.getAliases()
Returns the email addresses the user can send from.
-
.getMessageById()
Loads a single email message by its ID.
More Apps Script
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().
How I Send Invoice Emails Straight From a Google Sheet (With a Script You Can Copy)
A copy-ready Apps Script that emails invoices from a Google Sheet, flags bad rows, and nudges overdue clients once a week. A guest post by Tahir Abbas.
Read post →How to Send Google Forms Entries Automatically with Apps Script
Google Forms provides basic email notifications for form submissions, but enhancing these notifications with detailed summaries can significantly improve productivity and response management.
Read post →Automated Project Management in Google Sheets
When you have multiple people working on multiple tasks, and you want everyone to be on the page, what do you do? You can use a Google Sheet. But managing projects can be an intimidating task in Google Sheets. It's a lot of data entry, right? Especially when you have multiple people working on different tasks with different statuses across different projects. Data entry for multiple projects, with different people, tasks, and statuses – it gets messy fast! I'm no stranger to these issues...
Read post →