Sample code for 30+ languages & platforms
C++

Send HTML Email with Attachments

See more SMTP Examples

Demonstrates how to send an HTML email with file attachments.

Chilkat C++ Downloads

C++
#include <CkMailMan.h>
#include <CkEmail.h>
#include <CkStringBuilder.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.

    CkMailMan mailman;

    mailman.put_SmtpHost("smtp.my-starttls-mail-server.com");

    mailman.put_SmtpUsername("MY-SMTP-USERNAME");
    mailman.put_SmtpPassword("MY-SMTP-PASSWORD");

    mailman.put_StartTLS(true);
    mailman.put_SmtpPort(587);

    // Create a new email object
    CkEmail email;
    email.put_Subject("Test SMTP API to Send HTML Email with Attachments");
    email.put_From("Joe Programmer <joe@my-starttls-mail-server.com>");
    email.AddTo("Chilkat Support","support@chilkatsoft.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);

    // Send the HTML email.
    success = mailman.SendEmail(email);
    if (success != true) {
        std::cout << mailman.lastErrorText() << "\r\n";
        return;
    }

    success = mailman.CloseSmtpConnection();
    if (success != true) {
        std::cout << "Connection to SMTP server not closed cleanly." << "\r\n";
    }

    std::cout << "HTML email with attachments sent!" << "\r\n";
    }