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

PureBasic
IncludeFile "CkJsonObject.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.

    token.i = CkJsonObject::ckCreate()
    If token.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkJsonObject::ckLoadFile(token,"qa_data/tokens/hotmail.json")
    If success <> 1
        Debug "Could not read qa_data/tokens/hotmail.json from the private working directory."
        CkJsonObject::ckDispose(token)
        ProcedureReturn
    EndIf

    If (CkJsonObject::ckJsonTypeOf(token,"access_token") <> 1) OR (CkJsonObject::ckStringOfEquals(token,"access_token","",1) = 1)
        Debug "An OAuth access token is required. Authorize or refresh the account first."
        CkJsonObject::ckDispose(token)
        ProcedureReturn
    EndIf

    mailbox.s = "user@example.com"
    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkMailMan::setCkSmtpHost(mailman, "smtp-mail.outlook.com")
    CkMailMan::setCkSmtpPort(mailman, 587)
    CkMailMan::setCkSmtpSsl(mailman, 0)
    CkMailMan::setCkStartTLS(mailman, 1)
    CkMailMan::setCkRequireSslCertVerify(mailman, 1)
    ;  Microsoft SMTP submission uses STARTTLS on port 587, not implicit TLS on 465.
    CkMailMan::setCkSmtpUsername(mailman, mailbox)
    CkMailMan::setCkSmtpPassword(mailman, "")
    CkMailMan::setCkOAuth2AccessToken(mailman, CkJsonObject::ckStringOf(token,"access_token"))

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkFrom(email, mailbox)
    CkEmail::setCkSubject(email, "Sample message")
    CkEmail::setCkBody(email, "This message was sent through Microsoft SMTP using OAuth2.")
    success = CkEmail::ckAddTo(email,"Recipient","recipient@example.net")
    If success <> 1
        Debug "Could not add the recipient."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ;  This sends a real message. Replace the recipient with an address you control.
    success = CkMailMan::ckSendEmail(mailman,email)
    If success <> 1
        CkMailMan::ckCloseSmtpConnection(mailman)
        Debug "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.
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Microsoft accepted the message, but closing the connection failed. Do not resend it."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    Debug "Microsoft accepted the message for delivery."


    CkJsonObject::ckDispose(token)
    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure