Sample code for 30+ languages & platforms
Unicode C

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 Unicode C Downloads

Unicode C
#include <C_CkEmailW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmailW email;
    HCkStringBuilderW sbMime;
    HCkHttpW http;
    HCkHttpResponseW resp;
    const wchar_t *url;
    HCkJsonObjectW json;
    const wchar_t *id;
    HCkJsonObjectW json2;

    success = FALSE;

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

    email = CkEmailW_Create();

    // This example chooses to load an email from a file.
    success = CkEmailW_LoadEml(email,L"qa_data/eml/testEmail.eml");
    if (success == FALSE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkEmailW_Dispose(email);
        return;
    }

    // Get the email as MIME.
    sbMime = CkStringBuilderW_Create();
    CkEmailW_GetMimeSb(email,sbMime);

    http = CkHttpW_Create();
    resp = CkHttpResponseW_Create();

    CkHttpW_putAuthToken(http,L"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 = L"https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media";
    CkHttpW_putUncommonOptions(http,L"SendGzipped");
    success = CkHttpW_HttpSb(http,L"POST",url,sbMime,L"utf-8",L"message/rfc822",resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(sbMime);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    CkHttpW_putUncommonOptions(http,L"");

    // A status code of 200 indicates success.
    wprintf(L"Response status code: %d\n",CkHttpResponseW_getStatusCode(resp));
    wprintf(L"Response body:\n");
    wprintf(L"%s\n",CkHttpResponseW_bodyStr(resp));

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

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

    json = CkJsonObjectW_Create();
    CkJsonObjectW_Load(json,CkHttpResponseW_bodyStr(resp));
    id = CkJsonObjectW_stringOf(json,L"id");

    // Add the Inbox label to the inserted email so that it appears in Inbox.
    wprintf(L"---- 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 = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(json2,L"addLabelIds[0]",L"INBOX");

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

    success = CkHttpW_HttpJson(http,L"POST",url,json2,L"application/json",resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(sbMime);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(json);
        CkJsonObjectW_Dispose(json2);
        return;
    }

    // A status code of 200 indicates success.
    wprintf(L"Response status code: %d\n",CkHttpResponseW_getStatusCode(resp));
    wprintf(L"Response body:\n");
    wprintf(L"%s\n",CkHttpResponseW_bodyStr(resp));

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

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


    CkEmailW_Dispose(email);
    CkStringBuilderW_Dispose(sbMime);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(json);
    CkJsonObjectW_Dispose(json2);

    }