Sample code for 30+ languages & platforms
Unicode C++

Outlook Send Email using MIME Format

See more Outlook Examples

This example sends an email using MIME format via the Microsoft Graph Outlook REST API.

Chilkat Unicode C++ Downloads

Unicode C++
#include <CkHttpW.h>
#include <CkJsonObjectW.h>
#include <CkEmailW.h>
#include <CkStringBuilderW.h>
#include <CkBinDataW.h>
#include <CkHttpResponseW.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttpW http;

    // Use your previously obtained access token here:
    // See the following examples for getting an access token:
    //    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
    //    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
    //    Refresh Access Token (Azure AD v2.0 Endpoint).
    //    Refresh Access Token (Azure AD Endpoint).

    CkJsonObjectW jsonToken;
    success = jsonToken.LoadFile(L"qa_data/tokens/microsoftGraph.json");
    if (success == false) {
        wprintf(L"%s\n",jsonToken.lastErrorText());
        return;
    }

    http.put_AuthToken(jsonToken.stringOf(L"access_token"));

    // To send email, we'll POST to the following endpoint:
    // 
    // POST /users/{id | userPrincipalName}/sendMail
    // 
    // (The special keyword "me" may be used in place of a principal name.)
    // 

    // The body of the POST request will contain the MIME source of the email in base64 format.

    // Create a new email object
    CkEmailW email;
    email.put_Subject(L"Test Outlook API to Send HTML Email with Attachments");
    email.put_From(L"Mary <mary@somewhere.com>");
    email.AddTo(L"Joe",L"joe@example.com");

    // Add a plain-text alternative body, which will likely never be seen.
    // (It is shown if the receiving email client is incapable of displaying HTML email.)
    email.AddPlainTextAlternativeBody(L"This is a plain-text alternative body...");

    // Our HTML will include an image, so add the related image here.
    const wchar_t *contentIdStarfish = email.addRelatedFile(L"qa_data/jpg/starfish.jpg");
    if (email.get_LastMethodSuccess() == false) {
        wprintf(L"%s\n",email.lastErrorText());
        return;
    }

    // The src attribute for the image tag is set to the contentIdStarfish:
    CkStringBuilderW sbHtml;
    sbHtml.Append(L"<html><body><p>This is an HTML email with an embedded image.</p>");
    sbHtml.Append(L"<p><img src=\"cid:CONTENT_ID_STARFISH\" /></p></body></html>");
    int numReplacements = sbHtml.Replace(L"CONTENT_ID_STARFISH",contentIdStarfish);

    email.AddHtmlAlternativeBody(sbHtml.getAsString());

    // Finally, add some attachments to the email.
    // Add a file attachment.
    success = email.AddFileAttachment2(L"qa_data/pdf/fishing.pdf",L"application/pdf");
    if (success == false) {
        wprintf(L"%s\n",email.lastErrorText());
        return;
    }

    // Add an attachment where the content is contained in a string.
    const wchar_t *content = L"This is the content of the 2nd attached file.";
    email.AddStringAttachment(L"someText.txt",content);

    // Get the email as multi-line base64..
    CkBinDataW bdMime;
    email.GetMimeBd(bdMime);

    // Now get it as multi-line base64
    CkStringBuilderW sbBase64;
    bdMime.GetEncodedSb(L"base64_mime",sbBase64);

    // Send the HTTP POST (i.e. send the email)
    CkHttpResponseW resp;
    success = http.HttpSb(L"POST",L"https://graph.microsoft.com/v1.0/me/sendMail",sbBase64,L"utf-8",L"text/plain",resp);
    if (success == false) {
        wprintf(L"%s\n",http.lastErrorText());
        return;
    }

    // The send succeeded if the response status code = 202.
    // In the success case, there is no response body.  (We just get the response code to know that it succeeded.)
    if (resp.get_StatusCode() != 202) {
        CkJsonObjectW json;
        json.Load(resp.bodyStr());
        json.put_EmitCompact(false);
        wprintf(L"%s\n",json.emit());
        wprintf(L"Failed, response status code = %d\n",resp.get_StatusCode());
    }
    else {
        wprintf(L"Outlook Mail Sent.\n");
    }
    }