Sample code for 30+ languages & platforms
React Native Requires Chilkat v11.0.0+

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 React Native Downloads

React Native
import { Email, Http, HttpResponse, JsonObject, StringBuilder } from '@chilkat/react-native'

async function chilkatExample() {
  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  const email = new Email();

  // This example chooses to load an email from a file.
  try {
    email.loadEml('qa_data/eml/testEmail.eml');
  } catch {
    console.log(email.lastErrorText);
    return;
  }

  // Get the email as MIME.
  const sbMime = new StringBuilder();
  email.getMimeSb(sbMime);

  const http = new Http();
  const resp = new HttpResponse();

  http.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.

  let url = 'https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media';
  http.uncommonOptions = 'SendGzipped';
  try {
    await http.httpSbAsync('POST', url, sbMime, 'utf-8', 'message/rfc822', resp);
  } catch {
    console.log(http.lastErrorText);
    return;
  }

  http.uncommonOptions = '';

  // A status code of 200 indicates success.
  console.log(`Response status code: ${resp.statusCode}`);
  console.log('Response body:');
  console.log(resp.bodyStr);

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

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

  const json = new JsonObject();
  json.load(resp.bodyStr);
  const id = json.stringOf('id');

  // Add the Inbox label to the inserted email so that it appears in Inbox.
  console.log('---- 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"
  //     ]
  // }

  const json2 = new JsonObject();
  json2.updateString('addLabelIds[0]', 'INBOX');

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

  try {
    await http.httpJsonAsync('POST', url, json2, 'application/json', resp);
  } catch {
    console.log(http.lastErrorText);
    return;
  }

  // A status code of 200 indicates success.
  console.log(`Response status code: ${resp.statusCode}`);
  console.log('Response body:');
  console.log(resp.bodyStr);

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

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