Draft Mail with PowerShell and Microsoft Graph API

Recently, I updated our internal Invoice automation and wanted to send invoices automatically (cause the Invoice SAAS has a bad Offic 365 integration). In the first month, we wanted to check the Invoice Emails before sending them, so we manually published them as a Draft and clicked the Send button.

To learn more from Microsoft GRAPH API, see my Blog Series:
Part 1 – Authentication and Azure App – Use Microsoft Graph API with PowerShell – Part 1 » TechGuy
Part 2 – Oauth2.0 – Use Microsoft Graph API with PowerShell – Part 2 » TechGuy
Part 3 – First Powershell Script to get a Teams Lis and Walkthrough – Use Microsoft Graph API with PowerShell – Part 3 » TechGuy
Part 4 – this one – Use Microsoft Graph API with PowerShell – Part 4 » TechGuy

API Reference and Permissions

The official documentation is here: Send mail – Microsoft Graph v1.0 | Microsoft Docs

Azure App Registration Rights:

• Mail.Send

The Script

$clientID = "yourClientID"
$Clientsecret = "yourSecret"
$tenantID = "yourTenantID"

$MailSender = "michael.seidl@au2mator.com"

#Connect to GRAPH API
$tokenBody = @{
    Grant_Type    = "client_credentials"
    Scope         = "https://graph.microsoft.com/.default"
    Client_Id     = $clientId
    Client_Secret = $clientSecret
}
$tokenResponse = Invoke-RestMethod -Uri "https://login.microsoftonline.com/$tenantID/oauth2/v2.0/token" -Method POST -Body $tokenBody
$headers = @{
    "Authorization" = "Bearer $($tokenResponse.access_token)"
    "Content-type"  = "application/json"
}

#Send Mail    
#$URLsend = "https://graph.microsoft.com/v1.0/users/$MailSender/sendMail"
#compared to sending an email, we use the endpoint messages
$URLDraft = "https://graph.microsoft.com/v1.0/users/$MailSender/messages"

#Also the body is a bit different compared to send an email
$BodyJsonDraft = @"
                    {
                          "subject": "Hello World from Microsoft Graph API",
                          "body": {
                            "contentType": "HTML",
                            "content": "This is a draft Mail<br>
                            GRAPH <br>
                            API<br>
                            
                            "
                          },
                          "toRecipients": [
                            {
                              "emailAddress": {
                                "address": "michael.seidl@au2mator.com"
                              }
                            }
                          ]
                      }
"@

Invoke-RestMethod -Method POST -Uri $URLDraft -Headers $headers -Body $BodyJsonDraft

The Result

You should now see a Draft Message in your Folder.

GitHub Repo

Here you can find the GitHub Repo: Seidlm/Microsoft-Graph-API-Examples (github.com) with the FileName Send-Mail Draft.ps1

Michael Seidl aka Techguy
au2mate everything
#AutomationMindset