Send HTML Email with an Inline Image (Content-ID)
See more SMTP Examples
Attach an inline image and reference it with a cid URL. This standard MIME technique is useful across email clients, including iPhone Mail; display still depends on the recipient client. This sends a real message. Replace the recipient with an address you control.
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.
Microsoft reference documentation
Chilkat Tcl Downloads
load ./chilkat.dll
set success 0
# Assumes Chilkat is unlocked. See Global Unlock Sample.
set token [new_CkJsonObject]
set success [CkJsonObject_LoadFile $token "qa_data/tokens/office365.json"]
if {$success != 1} then {
puts "Could not read qa_data/tokens/office365.json from the private working directory."
delete_CkJsonObject $token
exit
}
if {expr [[CkJsonObject_JsonTypeOf $token "access_token"] != 1] || [[CkJsonObject_StringOfEquals $token "access_token" "" 1] == 1]} then {
puts "An OAuth access token is required. Authorize or refresh the account first."
delete_CkJsonObject $token
exit
}
set mailbox "user@example.com"
set mailman [new_CkMailMan]
CkMailMan_put_SmtpHost $mailman "smtp.office365.com"
CkMailMan_put_SmtpPort $mailman 587
CkMailMan_put_SmtpSsl $mailman 0
CkMailMan_put_StartTLS $mailman 1
CkMailMan_put_RequireSslCertVerify $mailman 1
# Microsoft SMTP submission uses STARTTLS on port 587, not implicit TLS on 465.
CkMailMan_put_SmtpUsername $mailman $mailbox
CkMailMan_put_SmtpPassword $mailman ""
CkMailMan_put_OAuth2AccessToken $mailman [CkJsonObject_stringOf $token "access_token"]
set email [new_CkEmail]
CkEmail_put_From $email $mailbox
CkEmail_put_Subject $email "Sample HTML message"
set success [CkEmail_AddTo $email "Recipient" "recipient@example.net"]
if {$success != 1} then {
puts "Could not add the recipient."
delete_CkJsonObject $token
delete_CkMailMan $mailman
delete_CkEmail $email
exit
}
set contentId [CkEmail_addRelatedFile $email "qa_data/jpg/starfish.jpg"]
if {expr [[CkEmail_get_LastMethodSuccess $email] != 1] || [$contentId == ""]} then {
puts "Could not add the related MIME item."
delete_CkJsonObject $token
delete_CkMailMan $mailman
delete_CkEmail $email
exit
}
set html [new_CkStringBuilder]
CkStringBuilder_Append $html "<html><body><p>Sample text.</p><img src=\"cid:CONTENT_ID\" alt=\"Inline image\"></body></html>"
set replaced [CkStringBuilder_Replace $html "CONTENT_ID" $contentId]
if {$replaced != 1} then {
puts "Could not insert the related Content-ID."
delete_CkJsonObject $token
delete_CkMailMan $mailman
delete_CkEmail $email
delete_CkStringBuilder $html
exit
}
CkEmail_SetHtmlBody $email [CkStringBuilder_getAsString $html]
# This sends a real message. Replace the recipient with an address you control.
set success [CkMailMan_SendEmail $mailman $email]
if {$success != 1} then {
CkMailMan_CloseSmtpConnection $mailman
puts "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.
delete_CkJsonObject $token
delete_CkMailMan $mailman
delete_CkEmail $email
delete_CkStringBuilder $html
exit
}
set success [CkMailMan_CloseSmtpConnection $mailman]
if {$success != 1} then {
puts "Microsoft accepted the message, but closing the connection failed. Do not resend it."
delete_CkJsonObject $token
delete_CkMailMan $mailman
delete_CkEmail $email
delete_CkStringBuilder $html
exit
}
puts "Microsoft accepted the message for delivery."
delete_CkJsonObject $token
delete_CkMailMan $mailman
delete_CkEmail $email
delete_CkStringBuilder $html