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

For more information, see https://learn.microsoft.com/en-us/graph/api/user-sendmail?view=graph-rest-1.0&tabs=http#example-4-send-a-new-message-using-mime-format

Chilkat C/C++ Library Downloads

MS Visual C/C++

Linux/CentOS C/C++

Alpine Linux C/C++

MAC OS X C/C++

armhf/aarch64 C/C++

C++ Builder

iOS C/C++

Android C/C++

Solaris C/C++

MinGW C/C++

#include <CkHttp.h>
#include <CkJsonObject.h>
#include <CkEmail.h>
#include <CkStringBuilder.h>
#include <CkBinData.h>
#include <CkHttpResponse.h>

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

    CkHttp 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).

    CkJsonObject jsonToken;
    bool success = jsonToken.LoadFile("qa_data/tokens/microsoftGraph.json");
    if (success == false) {
        std::cout << jsonToken.lastErrorText() << "\r\n";
        return;
    }

    http.put_AuthToken(jsonToken.stringOf("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
    CkEmail email;
    email.put_Subject("Test Outlook API to Send HTML Email with Attachments");
    email.put_From("Mary <mary@somewhere.com>");
    email.AddTo("Joe","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("This is a plain-text alternative body...");

    // Our HTML will include an image, so add the related image here.
    const char *contentIdStarfish = email.addRelatedFile("qa_data/jpg/starfish.jpg");
    if (email.get_LastMethodSuccess() != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

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

    email.AddHtmlAlternativeBody(sbHtml.getAsString());

    // Finally, add some attachments to the email.
    // Add a file attachment.
    success = email.AddFileAttachment2("qa_data/pdf/fishing.pdf","application/pdf");
    if (success != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

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

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

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

    // Send the HTTP POST (i.e. send the email)
    CkHttpResponse *resp = http.PTextSb("POST","https://graph.microsoft.com/v1.0/me/sendMail",sbBase64,"utf-8","text/plain",false,false);
    if (http.get_LastMethodSuccess() != true) {
        std::cout << http.lastErrorText() << "\r\n";
        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) {
        CkJsonObject json;
        json.Load(resp->bodyStr());
        json.put_EmitCompact(false);
        std::cout << json.emit() << "\r\n";
        std::cout << "Failed, response status code = " << resp->get_StatusCode() << "\r\n";
    }
    else {
        std::cout << "Outlook Mail Sent." << "\r\n";
    }

    delete resp;
    }