Microsoft Graph: Mail

Creates a new mail folder for a user in Microsoft Graph. This atomic requires one of the following Graph API scopes: Mail.ReadWrite.

Target: Microsoft Defender for Office 365 (Commercial or GCC) integration target or HTTP endpoint for "graph.microsoft.com"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and request payload
[] Create the mail folder
[] Check if the request was successful:
[]> If it was, attempt to extract the results and set the output variables
[]> If it wasn't, return an error

More information about this API: https://learn.microsoft.com/en-us/graph/api/user-post-mailfolders

Microsoft Graph - Create Mail Folder for User

prod-nam

prod-eu

prod-apjc

Deletes an email message from a mailbox using Microsoft Graph. This atomic requires the following API permission: Mail.ReadWrite.

Target: Microsoft Defender for Office 365 (Commercial or GCC) integration target or HTTP endpoint for "graph.microsoft.com"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header
[] Request the message be deleted
[] Check if the request was successful:
[]> If it wasn't, return an error

More information about this API: https://learn.microsoft.com/en-us/graph/api/message-delete

Microsoft Graph - Delete Mail Message

Searches for mail folders for a user using Microsoft Graph. This atomic requires one of the following API permissions: Mail.ReadWrite, Mail.Read.

Target: Microsoft Defender for Office 365 (Commercial or GCC) integration target or HTTP endpoint for "graph.microsoft.com"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and query string
[] Search for mail folders
[] Check if the request was successful:
[]> If it was, attempt to extract the results and set the output variables
[]> If it wasn't, return an error

More information about this API: https://learn.microsoft.com/en-us/graph/api/user-list-mailfolders

Microsoft Graph - Get Mail Folders for User

Gets a mail message using its ID from Microsoft Graph. This atomic requires one of the following API permissions: Mail.ReadBasic.All, Mail.Read.

Target: Microsoft Defender for Office 365 (Commercial or GCC) integration target or HTTP endpoint for "graph.microsoft.com"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Request to get mail message by ID
[] Check if the request was successful:
[]> If it was, attempt to extract the message and set the output variable
[]> If it wasn't, output an error

More information about this API: https://learn.microsoft.com/en-us/graph/api/message-get

Microsoft Graph - Get Mail Message by ID

Moves a message to another folder within the specified user's mailbox using Microsoft Graph. This atomic requires the following API permission: Mail.ReadWrite.

Target: Microsoft Defender for Office 365 (Commercial or GCC) integration target or HTTP endpoint for "graph.microsoft.com"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and request body
[] Request the message be moved
[] Check if the request was successful:
[]> If it wasn't, return an error

More information about this API: https://learn.microsoft.com/en-us/graph/api/message-move

Microsoft Graph - Move Mail Message to Folder

Searches for mail messages using Microsoft Graph. This atomic requires one of the following API permissions: Mail.ReadBasic.All, Mail.Read, Mail.ReadWrite.

Target: Microsoft Defender for Office 365 (Commercial or GCC) integration target or HTTP endpoint for "graph.microsoft.com"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and the query string
[] Search for mail messages
[] Check if the request was successful:
[]> If it was, attempt to extract the mail messages and set the output variable
[]> If it wasn't, return an error

More information about this API: https://learn.microsoft.com/en-us/graph/api/user-list-messages