Adds this label to the thread.

// Add label MyLabel to the first thread in the inboxconstlabel=GmailApp.getUserLabelByName('MyLabel');constfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.addLabel(label);

Parameters

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• removeLabel(label)

Creates a draft message replying to the sender of the last message in this thread using thereply-to address. The size of the email (including headers) isquota limited.

// Create a draft reply to the message author with an acknowledgement.constfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.createDraftReply('Got your message');

Parameters

Return

GmailDraft — the newly created draft message

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

Creates a draft message replying to the sender of the last message in this thread using thereply-to address, with optional arguments.

The email can contain both plain text and an HTML body. The size of the email (includingheaders) isquotalimited.

// Create a draft response with an HTML text body.constfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.createDraftReply('incapable of HTML',{htmlBody:'<b>some HTML body text</b>',cc:'another@example.com',});

Parameters

Advanced parameters

Return

GmailDraft — the newly created draft message

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

Creates a draft message replying to the sender of the last message in this thread, using thereply-to address and all recipients of this message. The size of the email (including headers)isquota limited.

// Create a draft reply to all recipients (except those bcc'd) of the last email// in this thread.constfirstThread=GmailApp.getInboxThreads(0,1)[0];constmessage=firstThread.getMessages()[0];message.createDraftReplyAll('Got your message');

Parameters

Return

GmailDraft — the newly created draft message

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

Creates a draft message replying to the sender of the last message in this thread, using thereply-to address and all recipients, with optional arguments.

The email can contain both plain text and an HTML body. The size of the email (includingheaders) isquotalimited.

// Create a draft reply, using an HTML text body, to all recipients (except// those bcc'd) of the last email of in this thread.constfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.createDraftReplyAll('incapable of HTML',{htmlBody:'<b>some HTML body text</b>',cc:'another@example.com',});

Parameters

Advanced parameters

Return

GmailDraft — the newly created draft message

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

Gets the subject of the first message in the thread.

// Log the subject of the first message in the first thread in the inboxconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(firstThread.getFirstMessageSubject());

Return

String — the subject of the first message in the thread

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• getLastMessageDate()

Gets the ID of this thread. The ID of a thread varies based on the messages it contains; for aconsistent ID for a particular message in the thread, callgetMessages()[0].getId()instead.

// Log the subject of the first message in the first thread in the inbox.constfirstThread=GmailApp.getInboxThreads(0,1)[0];constid=firstThread.getId();// Get same thread by its ID.constthread=GmailApp.getThreadById(id);Logger.log(thread.getFirstMessageSubject()===firstThread.getFirstMessageSubject(),);// True

Return

String — the ID of this thread

Returns the user-created labels on this thread.

// Log the names of the labels attached to the first thread in the inboxconstfirstThread=GmailApp.getInboxThreads(0,1)[0];constlabels=firstThread.getLabels();for(leti=0;i <labels.length;i++){Logger.log(labels[i].getName());}

Return

GmailLabel[] — an array of labels for this thread

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Gets the date of this thread's most recent message.

// Log the date of the most recent message on the first thread in the inboxconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(firstThread.getLastMessageDate());

Return

Date — the date of the most recent message in the thread

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• getFirstMessageSubject()

Returns the number of messages in the thread.

// Log the number of messages in the threadconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(firstThread.getMessageCount());

Return

Integer — the number of messages in the thread

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• getMessages()

Gets the messages in this thread.

// Log the subjects of the messages in the threadconstfirstThread=GmailApp.getInboxThreads(0,1)[0];constmessages=firstThread.getMessages();for(leti=0;i <messages.length;i++){Logger.log(messages[i].getSubject());}

Return

GmailMessage[] — an array of Gmail messages in this thread

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• getMessageCount()

Gets a permalink for this thread.

Note that this only works with the classic Gmail interface, not Inbox.

// Logs the permalink for the first thread in the inboxconstthread=GmailApp.getInboxThreads(0,1)[0];Logger.log(thread.getPermalink());

Return

String — the permalink for this thread

Returns whether the thread has any starred messages.

// Log if this thread has starred messagesconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`has starred :${firstThread.hasStarredMessages()}`);

Return

Boolean — true if the thread has any starred messages

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns whether the thread is marked as important.

// Log if this thread is marked as importantconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`Important? :${firstThread.isImportant()}`);

Return

Boolean — Whether the thread is marked as important.

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns whether the thread is labeled a chat.

// Log if this thread is a chatconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`is in chats? :${firstThread.isInChats()}`);

Return

Boolean — true if the thread is labeled a chat

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns whether the thread is in the inbox.

// Log if this thread is in the inboxconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`is in the inbox? :${firstThread.isInInbox()}`);

Return

Boolean — true if the thread is in the inbox

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns true if this thread is in the priority inbox; returns false otherwise.

// Log if this thread is in the priority inboxconstfirstThread=GmailApp.getPriorityInboxThreads(0,1)[0];Logger.log(`is in priority inbox?${firstThread.isInPriorityInbox()}`);

Return

Boolean — true if the thread is in the priority inbox

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns whether the thread is marked as spam.

// Log if this thread is in the spam folderconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`Spam?${firstThread.isInSpam()}`);

Return

Boolean — Whether this thread is marked as spam.

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns whether the thread is in the trash.

// Log if this thread is in the trashconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`Trashed?${firstThread.isInTrash()}`);

Return

Boolean — true if the thread is in the trash

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Returns whether the thread has any unread messages.

// Log if this thread is unreadconstfirstThread=GmailApp.getInboxThreads(0,1)[0];Logger.log(`Unread?${firstThread.isUnread()}`);

Return

Boolean — true if there are unread messages

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Marks this thread as important.

// Mark first inbox thread as importantconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.markImportant();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• markUnimportant()

Marks this thread as read.

// Mark first inbox thread as readconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.markRead();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• markUnread()

Marks this thread as unimportant.

// Mark first inbox thread as unimportantconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.markUnimportant();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• markImportant()

Marks this thread as unread.

// Mark first inbox thread as unreadconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.markUnread();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• markRead()

Moves this thread to the archive.

// Archive first inbox threadconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.moveToArchive();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Moves this thread to the inbox.

// Move first non-inbox thread to inboxconstfirstThread=GmailApp.search('-in:inbox')[0];firstThread.moveToInbox();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Moves this thread to spam.

// Move first inbox thread to spamconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.moveToSpam();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Moves this thread to the trash.

// Move first inbox thread to trashconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.moveToTrash();

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Reloads this thread, and associated state from Gmail (useful in case the labels, read state,etc., have changed).

constfirstThread=GmailApp.getInboxThreads(0,1)[0];// ...Do something that may take a while here....firstThread.refresh();// Make sure it's up-to-date// ...Do more stuff with firstThread ...

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

Removes this label from the thread.

constmyLabel=GmailApp.getUserLabelByName('<your label>');constthreads=myLabel.getThreads();for(constthreadofthreads){thread.removeLabel(myLabel);}

Parameters

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• addLabel(label)

Reply to the sender of the last message on this thread using the replyTo address.

Note that the total size of the email (including all headers) may not exceed 20KB.

// Respond to author of last email in thread with acknowledgmentconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.reply('Got your message');

Parameters

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

Reply to the sender of the last message on this thread using the replyTo address, with optionalarguments. The email can contain both plain text, and also an HTML body. Note that the totalsize of the email (including all headers, but excluding attachments) may not exceed 20KB.

// Respond with HTML body text.constfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.reply('incapable of HTML',{htmlBody:'some HTML body text',noReply:true,});

Parameters

Advanced parameters

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• reply(body)
• replyAll(body)
• replyAll(body, options)

Reply to the sender (using the replyTo address), and all recipients of the last message on thisthread.

Note that the total size of the email (including all headers) may not exceed 20KB.

// Respond to all with acknowledgment to the first thread in the inboxconstfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.replyAll('Got your message');

Parameters

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• reply(body, options)
• reply(body)
• replyAll(body, options)

Reply to the sender (using thereplyTo address), and all recipients of the last messageon this thread, with optional arguments. The email can contain both plain text, and also anHTML body. Note that the total size of the email (including all headers, but excludingattachments) may not exceed 20KB.

// Respond with HTML body text.constfirstThread=GmailApp.getInboxThreads(0,1)[0];firstThread.replyAll('incapable of HTML',{htmlBody:'some HTML body text',noReply:true,});

Parameters

Advanced parameters

Return

GmailThread — this thread, useful for chaining

Authorization

Scripts that use this method require authorization with one or more of the followingscopes or appropriate scopes from therelated REST API:

• https://mail.google.com/

See also

• reply(body)
• replyAll(body)
• replyAll(body, options)