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

Gmail SMTP: Send Email with OAuth2

See more GMail SMTP/IMAP/POP Examples

Send an email through smtp.gmail.com:587 with STARTTLS and an OAuth2 access token. Chilkat constructs the SASL XOAUTH2 authentication exchange; do not put the access token in SmtpPassword. Port 465 with implicit TLS is an alternative.

This example sends a real email. Set the mailbox to the account that authorized the token and use a recipient you control. The From address is that mailbox; another address must be an authorized Gmail send-as identity. Gmail normally saves SMTP submissions in Sent, so do not automatically append another copy through IMAP.

SMTP acceptance does not prove inbox delivery. Account sending limits, recipient limits, spam filtering, and Workspace policies still apply. A connection failure after message data was transmitted can leave the result uncertain; blind retries can create duplicate mail. Authentication/session logs can contain credentials and message data.

This example reads gmail-mail-token.json from a private working directory. Authorize the account first, then refresh the access token before it expires. The separate filename avoids confusing this full-mail grant with a narrower Gmail REST token. Store credentials in protected application storage; never distribute a user's token file with an application.

Gmail SMTP, IMAP, and POP3 use the https://mail.google.com/ OAuth scope. Narrower Gmail REST scopes such as gmail.send or gmail.readonly do not authorize these protocols. Public applications using this restricted scope must meet Google's verification requirements. See Gmail OAuth scopes and XOAUTH2.

Google documentation

Chilkat PowerBuilder Downloads

PowerBuilder
integer li_rc
long li_Success
oleobject loo_Token
string ls_Mailbox
oleobject loo_Mailman
oleobject loo_Email

li_Success = 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

loo_Token = create oleobject
li_rc = loo_Token.ConnectToNewObject("Chilkat.JsonObject")
if li_rc < 0 then
    destroy loo_Token
    MessageBox("Error","Connecting to COM object failed")
    return
end if
li_Success = loo_Token.LoadFile("gmail-mail-token.json")
if li_Success <> 1 then
    Write-Debug "Could not read gmail-mail-token.json from the private working directory."
    destroy loo_Token
    return
end if

if (loo_Token.JsonTypeOf("access_token") <> 1) OR (loo_Token.StringOfEquals("access_token","",1) = 1) then
    Write-Debug "An OAuth access token is required. Authorize or refresh the account first."
    destroy loo_Token
    return
end if

ls_Mailbox = "user@example.com"
loo_Mailman = create oleobject
li_rc = loo_Mailman.ConnectToNewObject("Chilkat.MailMan")

loo_Mailman.SmtpHost = "smtp.gmail.com"
loo_Mailman.SmtpPort = 587
loo_Mailman.SmtpSsl = 0
loo_Mailman.StartTLS = 1
loo_Mailman.RequireSslCertVerify = 1
//  Alternative: port 465 with SmtpSsl=true and StartTLS=false (implicit TLS).
loo_Mailman.SmtpUsername = ls_Mailbox
loo_Mailman.SmtpPassword = ""
loo_Mailman.OAuth2AccessToken = loo_Token.StringOf("access_token")

loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")

loo_Email.From = ls_Mailbox
loo_Email.Subject = "Sample message"
loo_Email.Body = "This message was sent through Gmail SMTP using OAuth2."
li_Success = loo_Email.AddTo("Recipient","recipient@example.net")
if li_Success <> 1 then
    Write-Debug "Could not add the recipient."
    destroy loo_Token
    destroy loo_Mailman
    destroy loo_Email
    return
end if

//  This sends a real message. Replace the recipient with an address you control.
li_Success = loo_Mailman.SendEmail(loo_Email)
if li_Success <> 1 then
    loo_Mailman.CloseSmtpConnection()
    Write-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.
    destroy loo_Token
    destroy loo_Mailman
    destroy loo_Email
    return
end if

li_Success = loo_Mailman.CloseSmtpConnection()
if li_Success <> 1 then
    Write-Debug "Gmail accepted the message, but closing the connection failed. Do not resend it."
    destroy loo_Token
    destroy loo_Mailman
    destroy loo_Email
    return
end if

Write-Debug "Gmail accepted the message for delivery."


destroy loo_Token
destroy loo_Mailman
destroy loo_Email