(PowerShell) Outlook Send Email

See more Outlook Examples

This example sends a simple plain-text email. Other examples exist for:

• Sending HTML email.
• Sending HTML email with embedded images.
• Sending email with attachments.
• Sending HTML email with embedded images and attachments.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

$http = New-Object Chilkat.Http

# Use your previously obtained access token here:
# See the following examples for getting an access token:
#    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
#    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
#    Refresh Access Token (Azure AD v2.0 Endpoint).
#    Refresh Access Token (Azure AD Endpoint).

$jsonToken = New-Object Chilkat.JsonObject
$success = $jsonToken.LoadFile("qa_data/tokens/microsoftGraph.json")
if ($success -eq $false) {
    $($jsonToken.LastErrorText)
    exit
}

$http.AuthToken = $jsonToken.StringOf("access_token")

# To send email, we'll POST to the following endpoint:
# 
# POST /users/{id | userPrincipalName}/sendMail
# 
# (The special keyword "me" may be used in place of a principal name.)
# 

# The body of the POST request contains JSON that specifies the email subject, body,
# recipients, etc.  This example will build the following JSON email:
# 

# 	{
# 	  "message": {
# 	    "subject": "Meet for lunch?",
# 	    "body": {
# 	      "contentType": "Text",
# 	      "content": "The new cafeteria is open."
# 	    },
# 	    "toRecipients": [
# 	      {
# 	        "emailAddress": {
# 		  "name": "Chilkat Software",
# 	          "address": "admin@chilkat.io"
# 	        }
# 	      },
# 	      {
# 	        "emailAddress": {
# 	          "address": "chilkat.support@gmail.com"
# 	        }
# 	      }
# 	    ],
# 	    "ccRecipients": [
# 	      {
# 	        "emailAddress": {
# 		  "name": "Chilkat Blog",
# 		  "address": "admin@cknotes.com"
# 	        }
# 	      }
# 	    ]
# 	  },
# 	  "saveToSentItems": true
# 	}
# 

# Build the above JSON.
$json = New-Object Chilkat.JsonObject
$json.UpdateString("message.subject","Meet for lunch?")
$json.UpdateString("message.body.contentType","Text")
$json.UpdateString("message.body.content","The new cafeteria is open.")
$json.UpdateString("message.toRecipients[0].emailAddress.name","Chilkat Software")
$json.UpdateString("message.toRecipients[0].emailAddress.address","admin@chilkat.io")
$json.UpdateString("message.toRecipients[1].emailAddress.address","chilkat.support@gmail.com")
$json.UpdateString("message.ccRecipients[0].emailAddress.name","Chilkat Blog")
$json.UpdateString("message.ccRecipients[0].emailAddress.address","admin@cknotes.com")
$json.UpdateBool("saveToSentItems",$true)

# Send the HTTP POST (i.e. send the email)
$resp = $http.PostJson2("https://graph.microsoft.com/v1.0/me/sendMail","application/json",$json.Emit())
if ($http.LastMethodSuccess -ne $true) {
    $($http.LastErrorText)
    exit
}

# The send succeeded if the response status code = 202.
# In the success case, there is no response body.  (We just get the response code to know that it succeeded.)
if ($resp.StatusCode -ne 202) {
    $json.Load($resp.BodyStr)
    $json.EmitCompact = $false
    $($json.Emit())
    $("Failed, response status code = " + $resp.StatusCode)
}
else {
    $("Outlook Mail Sent.")
}