Sample code for 30+ languages & platforms
Unicode C Requires Chilkat v11.0.0+

Send a Gmail message with a file attachment

See more GMail REST API Examples

Live send. Prepare a small file named attachment.pdf and replace the sample addresses. Add the file as a MIME attachment and upload the complete message as message/rfc822. The response is a Gmail Message. For larger uploads or unreliable connections, see Google’s resumable upload guidance.

Authorize the application with https://www.googleapis.com/auth/gmail.send. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat Unicode C Downloads

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObjectW token;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    HCkEmailW email;
    HCkBinDataW fileData;
    HCkBinDataW mime;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.

    token = CkJsonObjectW_Create();
    success = CkJsonObjectW_LoadFile(token,L"gmail-token.json");
    if (success != TRUE) {
        wprintf(L"Could not read gmail-token.json from the private working directory.\n");
        CkJsonObjectW_Dispose(token);
        return;
    }

    if ((CkJsonObjectW_JsonTypeOf(token,L"access_token") != 1) || (CkJsonObjectW_StringOfEquals(token,L"access_token",L"",TRUE) == TRUE)) {
        wprintf(L"An OAuth access token is required.\n");
        CkJsonObjectW_Dispose(token);
        return;
    }

    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    CkHttpW_putAuthToken(http,CkJsonObjectW_stringOf(token,L"access_token"));
    resp = CkHttpResponseW_Create();
    reply = CkJsonObjectW_Create();
    email = CkEmailW_Create();
    //  Use the authorized mailbox or one of its configured send-as addresses.
    CkEmailW_putFrom(email,L"Sender <sender@example.com>");
    success = CkEmailW_AddTo(email,L"Recipient",L"recipient@example.net");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        return;
    }

    CkEmailW_putSubject(email,L"Sample message");
    CkEmailW_putCharset(email,L"utf-8");
    CkEmailW_putBody(email,L"Hello from the Gmail API.");
    fileData = CkBinDataW_Create();
    success = CkBinDataW_LoadFile(fileData,L"attachment.pdf");
    if (success != TRUE) {
        wprintf(L"Could not read attachment.pdf.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        return;
    }

    success = CkEmailW_AddAttachmentBd(email,L"attachment.pdf",fileData,L"application/pdf");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        return;
    }

    mime = CkBinDataW_Create();
    success = CkEmailW_GetMimeBd(email,mime);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        CkBinDataW_Dispose(mime);
        return;
    }

    success = CkHttpW_HttpBd(http,L"POST",L"https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media",mime,L"message/rfc822",resp);
    if (CkHttpResponseW_getStatusCode(resp) == 0) {
        wprintf(L"Gmail did not return an HTTP response.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        CkBinDataW_Dispose(mime);
        return;
    }

    if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) < 200) || (CkHttpResponseW_getStatusCode(resp) >= 300)) {
        wprintf(L"Gmail HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
        success = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
        if (success == TRUE) {
            wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"error.message"));
        }

        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        CkBinDataW_Dispose(mime);
        return;
    }

    success = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
    if (success != TRUE) {
        wprintf(L"Expected a Gmail JSON response.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        CkBinDataW_Dispose(mime);
        return;
    }

    if ((CkJsonObjectW_JsonTypeOf(reply,L"id") != 1) || (CkJsonObjectW_StringOfEquals(reply,L"id",L"",TRUE) == TRUE)) {
        wprintf(L"Expected id in the response.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(fileData);
        CkBinDataW_Dispose(mime);
        return;
    }

    wprintf(L"Gmail message ID: %s\n",CkJsonObjectW_stringOf(reply,L"id"));


    CkJsonObjectW_Dispose(token);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkEmailW_Dispose(email);
    CkBinDataW_Dispose(fileData);
    CkBinDataW_Dispose(mime);

    }