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
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