Sample code for 30+ languages & platforms
Java

Insert Email into GMail Folder

See more GMail REST API Examples

Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.

This example will create a Chilkat Email object and upload/insert it into GMail. Then adds the "INBOX" label to the email to make it appear in INBOX

Chilkat Java Downloads

Java
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkEmail email = new CkEmail();

    // This example chooses to load an email from a file.
    success = email.LoadEml("qa_data/eml/testEmail.eml");
    if (success == false) {
        System.out.println(email.lastErrorText());
        return;
        }

    // Get the email as MIME.
    CkStringBuilder sbMime = new CkStringBuilder();
    email.GetMimeSb(sbMime);

    CkHttp http = new CkHttp();
    CkHttpResponse resp = new CkHttpResponse();

    http.put_AuthToken("GMAIL-ACCESS-TOKEN");

    // Upload to GMail (does not send, but just inserts).

    // IMPORTANT: After uploading/inserting, you won't see the message in the Inbox.
    // In your web browser, if you go to "All Mail", you will see it.

    String url = "https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media";
    http.put_UncommonOptions("SendGzipped");
    success = http.HttpSb("POST",url,sbMime,"utf-8","message/rfc822",resp);
    if (success == false) {
        System.out.println(http.lastErrorText());
        return;
        }

    http.put_UncommonOptions("");

    // A status code of 200 indicates success.
    System.out.println("Response status code: " + resp.get_StatusCode());
    System.out.println("Response body:");
    System.out.println(resp.bodyStr());

    // The response body contains JSON.
    // A sample successful JSON response:

    // {
    //  "id": "166f583051d36144",
    //  "threadId": "166f5529e079a456"
    // }

    CkJsonObject json = new CkJsonObject();
    json.Load(resp.bodyStr());
    String id = json.stringOf("id");

    // Add the Inbox label to the inserted email so that it appears in Inbox.
    System.out.println("---- Adding the Inbox label to the newly inserted email. ----");

    // Create the following JSON to be sent in a POST to modify labels for this message.
    // {
    //   "addLabelIds": [
    //     "INBOX"
    //     ]
    // }

    CkJsonObject json2 = new CkJsonObject();
    json2.UpdateString("addLabelIds[0]","INBOX");

    http.SetUrlVar("id",id);
    url = "https://www.googleapis.com/gmail/v1/users/me/messages/{$id}/modify";

    success = http.HttpJson("POST",url,json2,"application/json",resp);
    if (success == false) {
        System.out.println(http.lastErrorText());
        return;
        }

    // A status code of 200 indicates success.
    System.out.println("Response status code: " + resp.get_StatusCode());
    System.out.println("Response body:");
    System.out.println(resp.bodyStr());

    // The response body contains JSON.
    // A sample successful JSON response:

    // {
    //  "id": "166f583051d36144",
    //  "threadId": "166f583051d36144",
    //  "labelIds": [
    //   "INBOX"
    //  ]
    // }
  }
}