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.
Chilkat DataFlex Downloads
Use ChilkatAx-win32.pkg
Procedure Test
Boolean iSuccess
Variant vKey
Handle hoKey
Handle hoAuth
String sMailbox
Variant vConnection
Handle hoConnection
Handle hoMailman
Variant vEmail
Handle hoEmail
String sTemp1
Move False To iSuccess
// Assumes Chilkat is unlocked. See Global Unlock Sample.
Get Create (RefClass(cComChilkatPfx)) To hoKey
If (Not(IsComObjectCreated(hoKey))) Begin
Send CreateComObject of hoKey
End
Get ComLoadPfxFile Of hoKey "gmail-service-account.p12" "P12_PASSWORD" To iSuccess
If (iSuccess <> True) Begin
Showln "Could not load the legacy P12 private key. Check its path and password privately."
Procedure_Return
End
Get Create (RefClass(cComChilkatAuthGoogle)) To hoAuth
If (Not(IsComObjectCreated(hoAuth))) Begin
Send CreateComObject of hoAuth
End
Set ComEmailAddress Of hoAuth To "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
Get pvComObject of hoKey to vKey
Get ComSetP12 Of hoAuth vKey To iSuccess
If (iSuccess <> True) Begin
Showln "Could not set the service-account private key."
Procedure_Return
End
Move "user@example.com" To sMailbox
Set ComScope Of hoAuth To "https://mail.google.com/"
Set ComSubEmailAddress Of hoAuth To sMailbox
Set ComExpireNumSeconds Of hoAuth To 3600
// AuthGoogle performs its Google token exchange over this TLS connection.
Get Create (RefClass(cComChilkatSocket)) To hoConnection
If (Not(IsComObjectCreated(hoConnection))) Begin
Send CreateComObject of hoConnection
End
Set ComRequireSslCertVerify Of hoConnection To True
Get ComConnect Of hoConnection "www.googleapis.com" 443 True 10000 To iSuccess
If (iSuccess <> True) Begin
Showln "Could not establish the Google token connection."
Procedure_Return
End
Get pvComObject of hoConnection to vConnection
Get ComObtainAccessToken Of hoAuth vConnection To iSuccess
Get ComClose Of hoConnection 1000 To iSuccess
If (iSuccess <> True) Begin
Showln "Token exchange failed. Check the key, delegated scope, user, and computer clock."
Procedure_Return
End
// Keep the token in memory. Never print tokens or private keys.
Get Create (RefClass(cComChilkatMailMan)) To hoMailman
If (Not(IsComObjectCreated(hoMailman))) Begin
Send CreateComObject of hoMailman
End
Set ComSmtpHost Of hoMailman To "smtp.gmail.com"
Set ComSmtpPort Of hoMailman To 587
Set ComSmtpSsl Of hoMailman To False
Set ComStartTLS Of hoMailman To True
Set ComRequireSslCertVerify Of hoMailman To True
// Alternative: port 465 with SmtpSsl=true and StartTLS=false (implicit TLS).
Set ComSmtpUsername Of hoMailman To sMailbox
Set ComSmtpPassword Of hoMailman To ""
Get ComAccessToken Of hoAuth To sTemp1
Set ComOAuth2AccessToken Of hoMailman To sTemp1
Get Create (RefClass(cComChilkatEmail)) To hoEmail
If (Not(IsComObjectCreated(hoEmail))) Begin
Send CreateComObject of hoEmail
End
Set ComFrom Of hoEmail To sMailbox
Set ComSubject Of hoEmail To "Sample message"
Set ComBody Of hoEmail To "This message was sent through Gmail SMTP using OAuth2."
Get ComAddTo Of hoEmail "Recipient" "recipient@example.net" To iSuccess
If (iSuccess <> True) Begin
Showln "Could not add the recipient."
Procedure_Return
End
// This sends a real message. Replace the recipient with an address you control.
Get pvComObject of hoEmail to vEmail
Get ComSendEmail Of hoMailman vEmail To iSuccess
If (iSuccess <> True) Begin
Get ComCloseSmtpConnection Of hoMailman To iSuccess
Showln "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.
Procedure_Return
End
Get ComCloseSmtpConnection Of hoMailman To iSuccess
If (iSuccess <> True) Begin
Showln "Gmail accepted the message, but closing the connection failed. Do not resend it."
Procedure_Return
End
Showln "Gmail accepted the message for delivery."
End_Procedure