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

CkPerl
use chilkat();

$success = 0;

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

$token = chilkat::CkJsonObject->new();
$success = $token->LoadFile("qa_data/tokens/hotmail.json");
if ($success != 1) {
    print "Could not read qa_data/tokens/hotmail.json from the private working directory." . "\r\n";
    exit;
}

if (($token->JsonTypeOf("access_token") != 1) or ($token->StringOfEquals("access_token","",1) == 1)) {
    print "An OAuth access token is required. Authorize or refresh the account first." . "\r\n";
    exit;
}

$mailbox = 'user@example.com';
$mailman = chilkat::CkMailMan->new();
$mailman->put_SmtpHost("smtp-mail.outlook.com");
$mailman->put_SmtpPort(587);
$mailman->put_SmtpSsl(0);
$mailman->put_StartTLS(1);
$mailman->put_RequireSslCertVerify(1);
#  Microsoft SMTP submission uses STARTTLS on port 587, not implicit TLS on 465.
$mailman->put_SmtpUsername($mailbox);
$mailman->put_SmtpPassword("");
$mailman->put_OAuth2AccessToken($token->stringOf("access_token"));

$email = chilkat::CkEmail->new();
$email->put_From($mailbox);
$email->put_Subject("Sample message");
$email->put_Body("This message was sent through Microsoft SMTP using OAuth2.");
$success = $email->AddTo("Recipient",'recipient@example.net');
if ($success != 1) {
    print "Could not add the recipient." . "\r\n";
    exit;
}

#  This sends a real message. Replace the recipient with an address you control.
$success = $mailman->SendEmail($email);
if ($success != 1) {
    $mailman->CloseSmtpConnection();
    print "SMTP send failed. Check the token, mailbox, recipient, and SMTP AUTH policy." . "\r\n";
    #  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
    #  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
    exit;
}

$success = $mailman->CloseSmtpConnection();
if ($success != 1) {
    print "Microsoft accepted the message, but closing the connection failed. Do not resend it." . "\r\n";
    exit;
}

print "Microsoft accepted the message for delivery." . "\r\n";