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

Gmail SMTP: Legacy Workspace Service Account P12 Key

See more GMail REST API Examples

Legacy key format: Google still supports P12 service-account keys for backward compatibility. For new applications use the JSON-key example. This page is retained for applications that already have a P12 key; supply its actual password and the service-account email address separately.

Obtain a short-lived OAuth2 token for a Google Workspace user's mailbox, then send email using Gmail SMTP. This requires a Workspace administrator to authorize the service account's numeric OAuth client ID for https://mail.google.com/ in domain-wide delegation. Enable domain-wide delegation for the service account and impersonate a user with an active Gmail mailbox.

This is a signed JWT bearer grant with user impersonation, not an OAuth client-credentials grant. A service account has no Gmail mailbox of its own. This approach does not provide delegated access to personal @gmail.com accounts. Protect the private key and restrict who can run the application; anyone with this key can exercise its delegated privileges.

Set SubEmailAddress and the SMTP username to the same Workspace mailbox. Keep the computer clock accurate. The token lasts at most one hour and has no refresh token: obtain a new delegated token when needed. Gmail's normal sending limits still apply; delegation does not permit unlimited sending.

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.

Google documentation

Chilkat AutoIt Downloads

AutoIt
Local $bSuccess = False

;  Assumes Chilkat is unlocked. See Global Unlock Sample.

$oKey = ObjCreate("Chilkat.Pfx")
$bSuccess = $oKey.LoadPfxFile("gmail-service-account.p12","P12_PASSWORD")
If ($bSuccess <> True) Then
    ConsoleWrite("Could not load the legacy P12 private key. Check its path and password privately." & @CRLF)
    Exit
EndIf

$oAuth = ObjCreate("Chilkat.AuthGoogle")
$oAuth.EmailAddress = "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
$bSuccess = $oAuth.SetP12($oKey)
If ($bSuccess <> True) Then
    ConsoleWrite("Could not set the service-account private key." & @CRLF)
    Exit
EndIf

Local $sMailbox = "user@example.com"
$oAuth.Scope = "https://mail.google.com/"
$oAuth.SubEmailAddress = $sMailbox
$oAuth.ExpireNumSeconds = 3600

;  AuthGoogle performs its Google token exchange over this TLS connection.
$oConnection = ObjCreate("Chilkat.Socket")
$oConnection.RequireSslCertVerify = True
$bSuccess = $oConnection.Connect("www.googleapis.com",443,True,10000)
If ($bSuccess <> True) Then
    ConsoleWrite("Could not establish the Google token connection." & @CRLF)
    Exit
EndIf

$bSuccess = $oAuth.ObtainAccessToken($oConnection)
$oConnection.Close(1000)
If ($bSuccess <> True) Then
    ConsoleWrite("Token exchange failed. Check the key, delegated scope, user, and computer clock." & @CRLF)
    Exit
EndIf

;  Keep the token in memory. Never print tokens or private keys.
$oMailman = ObjCreate("Chilkat.MailMan")
$oMailman.SmtpHost = "smtp.gmail.com"
$oMailman.SmtpPort = 587
$oMailman.SmtpSsl = False
$oMailman.StartTLS = True
$oMailman.RequireSslCertVerify = True
;  Alternative: port 465 with SmtpSsl=true and StartTLS=false (implicit TLS).
$oMailman.SmtpUsername = $sMailbox
$oMailman.SmtpPassword = ""
$oMailman.OAuth2AccessToken = $oAuth.AccessToken

$oEmail = ObjCreate("Chilkat.Email")
$oEmail.From = $sMailbox
$oEmail.Subject = "Sample message"
$oEmail.Body = "This message was sent through Gmail SMTP using OAuth2."
$bSuccess = $oEmail.AddTo("Recipient","recipient@example.net")
If ($bSuccess <> True) Then
    ConsoleWrite("Could not add the recipient." & @CRLF)
    Exit
EndIf

;  This sends a real message. Replace the recipient with an address you control.
$bSuccess = $oMailman.SendEmail($oEmail)
If ($bSuccess <> True) Then
    $oMailman.CloseSmtpConnection()
    ConsoleWrite("SMTP send failed. Check the token, mailbox, recipient, and Gmail sending limits." & @CRLF)
    ;  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
    ;  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
    Exit
EndIf

$bSuccess = $oMailman.CloseSmtpConnection()
If ($bSuccess <> True) Then
    ConsoleWrite("Gmail accepted the message, but closing the connection failed. Do not resend it." & @CRLF)
    Exit
EndIf

ConsoleWrite("Gmail accepted the message for delivery." & @CRLF)