Microsoft 365 SMTP: Send Email with OAuth2
See more SMTP Examples
Send an email through Exchange Online using OAuth2 and verified STARTTLS. This sends a real message. Keep From and the authenticated mailbox aligned; sending as another mailbox requires Send As permission.
Microsoft 365 work/school: The account needs an Exchange Online mailbox. SMTP submission uses smtp.office365.com:587 with STARTTLS. An administrator must allow SMTP AUTH for the mailbox under the tenant's security policy; a valid OAuth token cannot enable a disabled protocol. Security defaults can block SMTP AUTH: have the administrator choose an approved configuration or mail API rather than disabling protections just to run a sample. See SMTP AUTH settings. Personal Outlook.com accounts instead use smtp-mail.outlook.com and delegated user authorization.
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/office365.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.
Basic authentication for IMAP and POP has been removed. SMTP AUTH Basic authentication follows a separate, changing retirement schedule; use OAuth2 for new code. See Microsoft's updated SMTP Basic authentication timeline.
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/office365.json")
IF (lnSuccess <> 1) THEN
? "Could not read qa_data/tokens/office365.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.office365.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