Using Gmail JavaScript API to Search Email Threads

Published in: Gmail - Javascript

This code uses the Gmail JavaScript API to search the inbox of the authenticated user (userId = me) for email threads that match the specified query. You need to create a new project in Google developer console with the Gmail API enabled.

The scope can be since this Gmail app requires only read only access to the user’s mailbox.

var threads = function listGmailThreads(userId, query, callback) {
    var getPageOfThreads = function (request, result) {
        request.execute(function (resp) {
            result = result.concat(resp.threads);
            var nextPageToken = resp.nextPageToken;
            if (nextPageToken) {
                request ={
                    'userId': userId,
                    'q': query,
                    'pageToken': nextPageToken
                getPageOfThreads(request, result);
            } else {
    var request ={
        'userId': userId,
        'q': query
    getPageOfThreads(request, []);
Published in: Gmail - Javascript

Looking for something? Find here!

Meet the Author

Web Geek, Google Developer Expert
Amit Agarwal

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. He is the developer of Mail Merge for Gmail and Document Studio. Read more on Lifehacker and YourStory

Get in touch