Sample code for 30+ languages & platforms
PHP Extension

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 PHP Extension Downloads

PHP Extension
<?php

include("chilkat.php");

$success = false;

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

$email = new CkEmail();

// This example chooses to load an email from a file.
$success = $email->LoadEml('qa_data/eml/testEmail.eml');
if ($success == false) {
    print $email->lastErrorText() . "\n";
    exit;
}

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

$http = new CkHttp();
$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.

$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) {
    print $http->lastErrorText() . "\n";
    exit;
}

$http->put_UncommonOptions('');

// A status code of 200 indicates success.
print 'Response status code: ' . $resp->get_StatusCode() . "\n";
print 'Response body:' . "\n";
print $resp->bodyStr() . "\n";

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

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

$json = new CkJsonObject();
$json->Load($resp->bodyStr());
$id = $json->stringOf('id');

// Add the Inbox label to the inserted email so that it appears in Inbox.
print '---- Adding the Inbox label to the newly inserted email. ----' . "\n";

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

$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) {
    print $http->lastErrorText() . "\n";
    exit;
}

// A status code of 200 indicates success.
print 'Response status code: ' . $resp->get_StatusCode() . "\n";
print 'Response body:' . "\n";
print $resp->bodyStr() . "\n";

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

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

?>