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

Gmail SMTP: Send with OAuth2 on Port 465

Send email through Gmail with implicit TLS on port 465 and OAuth2. Set SmtpSsl=true and StartTLS=false. This replaces the old ordinary-password example while preserving its URL.

This sends a real message. Set the From address to the authorized mailbox or a permitted send-as identity and use a recipient you control. SMTP acceptance does not guarantee delivery. Gmail sending limits still apply. After an uncertain submission, verify the outcome before retrying.

First authorize the mailbox for https://mail.google.com/ and refresh the token as needed. Read the current token from gmail-mail-token.json in a private working directory. Narrow Gmail REST scopes do not authorize these protocols. Keep the token and authentication logs private.

See the Gmail SMTP, IMAP, and POP3 guide for current authentication choices and Gmail-specific examples.

Reference documentation

Chilkat PureBasic Downloads

PureBasic
IncludeFile "CkJsonObject.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.

    token.i = CkJsonObject::ckCreate()
    If token.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkJsonObject::ckLoadFile(token,"gmail-mail-token.json")
    If success <> 1
        Debug "Could not read gmail-mail-token.json from the private working directory."
        CkJsonObject::ckDispose(token)
        ProcedureReturn
    EndIf

    If (CkJsonObject::ckJsonTypeOf(token,"access_token") <> 1) OR (CkJsonObject::ckStringOfEquals(token,"access_token","",1) = 1)
        Debug "An OAuth access token is required. Authorize or refresh the account first."
        CkJsonObject::ckDispose(token)
        ProcedureReturn
    EndIf

    mailbox.s = "user@example.com"
    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkMailMan::setCkSmtpHost(mailman, "smtp.gmail.com")
    CkMailMan::setCkSmtpPort(mailman, 465)
    CkMailMan::setCkSmtpSsl(mailman, 1)
    CkMailMan::setCkStartTLS(mailman, 0)
    CkMailMan::setCkRequireSslCertVerify(mailman, 1)
    ;  Alternative: port 587 with SmtpSsl=false and StartTLS=true.
    CkMailMan::setCkSmtpUsername(mailman, mailbox)
    CkMailMan::setCkSmtpPassword(mailman, "")
    CkMailMan::setCkOAuth2AccessToken(mailman, CkJsonObject::ckStringOf(token,"access_token"))

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkFrom(email, mailbox)
    CkEmail::setCkSubject(email, "Sample message")
    CkEmail::setCkBody(email, "This message was sent through Gmail SMTP using OAuth2.")
    success = CkEmail::ckAddTo(email,"Recipient","recipient@example.net")
    If success <> 1
        Debug "Could not add the recipient."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ;  This sends a real message. Replace the recipient with an address you control.
    success = CkMailMan::ckSendEmail(mailman,email)
    If success <> 1
        CkMailMan::ckCloseSmtpConnection(mailman)
        Debug "SMTP send failed. Check the token, mailbox, recipient, and Gmail sending limits."
        ;  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
        ;  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Gmail accepted the message, but closing the connection failed. Do not resend it."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    Debug "Gmail accepted the message for delivery."


    CkJsonObject::ckDispose(token)
    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure