Send an Email via SMTP

See more SMTP Examples

Demonstrates the Chilkat MailMan.SendEmail method, which sends a single Email object through the configured SMTP server. This example configures the SMTP connection, builds a message, and sends it.

Background: SMTP (Simple Mail Transfer Protocol) is the protocol for sending mail. The typical flow is: connect to the server, authenticate, then hand over the message with MAIL FROM, RCPT TO, and DATA. SendEmail wraps all of that: you build an Email with subject, recipients, and body, and Chilkat renders it to MIME and delivers it. Modern submission commonly uses implicit TLS on port 465 (SmtpSsl = true).

Chilkat C Downloads

Download Chilkat for C

#include <C_CkMailMan.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mailman;
    HCkEmail email;

    success = FALSE;

    //  Demonstrates the MailMan.SendEmail method, which sends a single Email object through the
    //  configured SMTP server.

    mailman = CkMailMan_Create();

    //  Configure the SMTP server connection.
    CkMailMan_putSmtpHost(mailman,"smtp.example.com");
    CkMailMan_putSmtpPort(mailman,465);
    CkMailMan_putSmtpSsl(mailman,TRUE);
    CkMailMan_putSmtpUsername(mailman,"user@example.com");
    CkMailMan_putSmtpPassword(mailman,"myPassword");

    //  Build the email to send.
    email = CkEmail_Create();
    CkEmail_putSubject(email,"Test email from Chilkat");
    CkEmail_putFrom(email,"alice@example.com");
    CkEmail_AddTo(email,"Bob","bob@example.com");
    CkEmail_putBody(email,"Hello, this is a test message.");

    //  Send the email.

    success = CkMailMan_SendEmail(mailman,email);
    if (success == FALSE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        return;
    }

    printf("Email sent.\n");

    //  Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
    //  connects and authenticates -- using the property settings above -- whenever a server
    //  operation requires it.  Calling the explicit connect/authenticate methods can still be
    //  helpful to determine whether a failure occurs while connecting or while authenticating.


    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(email);

    }