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

Outlook.com SMTP: Send Email with OAuth2

See more SMTP Examples

Submit a message using a personal Microsoft mailbox and a previously obtained OAuth2 access token. This sends a real message. Use a recipient you control. The From address matches the authenticated mailbox; other sender identities require provider authorization. SMTP acceptance is not proof of final delivery.

Personal Outlook.com: This includes Microsoft-hosted Outlook.com, Hotmail, and Live mailboxes. Use delegated OAuth2; ordinary passwords and app passwords are not a replacement for Modern Authentication. SMTP uses smtp-mail.outlook.com:587 with STARTTLS; incoming IMAP/POP use outlook.office365.com on ports 993/995 with implicit TLS. Enable POP or IMAP under Settings > Mail > Forwarding and IMAP before using that protocol. See current Outlook.com settings.

First authorize the account with https://outlook.office.com/SMTP.Send and offline_access, then refresh the access token when needed. This example reads qa_data/tokens/hotmail.json from a private working directory. Microsoft Graph permissions such as Mail.Send or Mail.Read do not authorize these mail protocols. Do not print tokens or authentication logs.

Microsoft reference documentation

Chilkat Visual FoxPro Downloads

Visual FoxPro
LOCAL lnSuccess
LOCAL loToken
LOCAL lcMailbox
LOCAL loMailman
LOCAL loEmail

lnSuccess = 0

*  Assumes Chilkat is unlocked. See Global Unlock Sample.

loToken = CreateObject('Chilkat.JsonObject')
lnSuccess = loToken.LoadFile("qa_data/tokens/hotmail.json")
IF (lnSuccess <> 1) THEN
    ? "Could not read qa_data/tokens/hotmail.json from the private working directory."
    RELEASE loToken
    CANCEL
ENDIF

IF ((loToken.JsonTypeOf("access_token") <> 1) OR (loToken.StringOfEquals("access_token","",1) = 1)) THEN
    ? "An OAuth access token is required. Authorize or refresh the account first."
    RELEASE loToken
    CANCEL
ENDIF

lcMailbox = "user@example.com"
loMailman = CreateObject('Chilkat.MailMan')
loMailman.SmtpHost = "smtp-mail.outlook.com"
loMailman.SmtpPort = 587
loMailman.SmtpSsl = 0
loMailman.StartTLS = 1
loMailman.RequireSslCertVerify = 1
*  Microsoft SMTP submission uses STARTTLS on port 587, not implicit TLS on 465.
loMailman.SmtpUsername = lcMailbox
loMailman.SmtpPassword = ""
loMailman.OAuth2AccessToken = loToken.StringOf("access_token")

loEmail = CreateObject('Chilkat.Email')
loEmail.From = lcMailbox
loEmail.Subject = "Sample message"
loEmail.Body = "This message was sent through Microsoft SMTP using OAuth2."
lnSuccess = loEmail.AddTo("Recipient","recipient@example.net")
IF (lnSuccess <> 1) THEN
    ? "Could not add the recipient."
    RELEASE loToken
    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 SMTP AUTH policy."
    *  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
    *  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
    RELEASE loToken
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

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

? "Microsoft accepted the message for delivery."

RELEASE loToken
RELEASE loMailman
RELEASE loEmail