Sample code for 30+ languages & platforms
Visual FoxPro 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 Visual FoxPro Downloads

Visual FoxPro
LOCAL lnSuccess
LOCAL loKey
LOCAL loAuth
LOCAL lcMailbox
LOCAL loConnection
LOCAL loMailman
LOCAL loEmail

lnSuccess = 0

*  Assumes Chilkat is unlocked. See Global Unlock Sample.

loKey = CreateObject('Chilkat.Pfx')
lnSuccess = loKey.LoadPfxFile("gmail-service-account.p12","P12_PASSWORD")
IF (lnSuccess <> 1) THEN
    ? "Could not load the legacy P12 private key. Check its path and password privately."
    RELEASE loKey
    CANCEL
ENDIF

loAuth = CreateObject('Chilkat.AuthGoogle')
loAuth.EmailAddress = "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
lnSuccess = loAuth.SetP12(loKey)
IF (lnSuccess <> 1) THEN
    ? "Could not set the service-account private key."
    RELEASE loKey
    RELEASE loAuth
    CANCEL
ENDIF

lcMailbox = "user@example.com"
loAuth.Scope = "https://mail.google.com/"
loAuth.SubEmailAddress = lcMailbox
loAuth.ExpireNumSeconds = 3600

*  AuthGoogle performs its Google token exchange over this TLS connection.
loConnection = CreateObject('Chilkat.Socket')
loConnection.RequireSslCertVerify = 1
lnSuccess = loConnection.Connect("www.googleapis.com",443,1,10000)
IF (lnSuccess <> 1) THEN
    ? "Could not establish the Google token connection."
    RELEASE loKey
    RELEASE loAuth
    RELEASE loConnection
    CANCEL
ENDIF

lnSuccess = loAuth.ObtainAccessToken(loConnection)
loConnection.Close(1000)
IF (lnSuccess <> 1) THEN
    ? "Token exchange failed. Check the key, delegated scope, user, and computer clock."
    RELEASE loKey
    RELEASE loAuth
    RELEASE loConnection
    CANCEL
ENDIF

*  Keep the token in memory. Never print tokens or private keys.
loMailman = CreateObject('Chilkat.MailMan')
loMailman.SmtpHost = "smtp.gmail.com"
loMailman.SmtpPort = 587
loMailman.SmtpSsl = 0
loMailman.StartTLS = 1
loMailman.RequireSslCertVerify = 1
*  Alternative: port 465 with SmtpSsl=true and StartTLS=false (implicit TLS).
loMailman.SmtpUsername = lcMailbox
loMailman.SmtpPassword = ""
loMailman.OAuth2AccessToken = loAuth.AccessToken

loEmail = CreateObject('Chilkat.Email')
loEmail.From = lcMailbox
loEmail.Subject = "Sample message"
loEmail.Body = "This message was sent through Gmail SMTP using OAuth2."
lnSuccess = loEmail.AddTo("Recipient","recipient@example.net")
IF (lnSuccess <> 1) THEN
    ? "Could not add the recipient."
    RELEASE loKey
    RELEASE loAuth
    RELEASE loConnection
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

*  This sends a real message. Replace the recipient with an address you control.
lnSuccess = loMailman.SendEmail(loEmail)
IF (lnSuccess <> 1) THEN
    loMailman.CloseSmtpConnection()
    ? "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.
    RELEASE loKey
    RELEASE loAuth
    RELEASE loConnection
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

lnSuccess = loMailman.CloseSmtpConnection()
IF (lnSuccess <> 1) THEN
    ? "Gmail accepted the message, but closing the connection failed. Do not resend it."
    RELEASE loKey
    RELEASE loAuth
    RELEASE loConnection
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

? "Gmail accepted the message for delivery."

RELEASE loKey
RELEASE loAuth
RELEASE loConnection
RELEASE loMailman
RELEASE loEmail