Show / Hide Table of Contents

ThreatSubmission.Read

Allows the app to read the threat submissions and threat submission policies owned by the signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 D GET /security/threatSubmission/emailThreats
V1 D GET /security/threatSubmission/emailThreats/{emailThreatsId}
V1 D GET /security/threatSubmission/fileThreats
V1 D GET /security/threatSubmission/fileThreats/{fileThreatsId}
V1 D GET /security/threatSubmission/urlThreats
V1 D GET /security/threatSubmission/urlThreats/{urlThreatsId}
V1 D GET security/threatSubmission//emailThreatSubmissionPolicies/{emailThreatSubmissionPoliciesId}
V1 D GET security/threatSubmission/emailThreatSubmissionPolicies

Delegate Permission

Id fd5353c6-26dd-449f-a565-c4e16b9fce78
Consent Type User
Display String Read threat submissions
Description Allows the app to read the threat submissions and threat submission policies owned by the signed-in user.

Resources

emailThreatSubmission

Property Type Description
attackSimulationInfo security.attackSimulationInfo If the email is phishing simulation, this field will not be null.
internetMessageId String Specifies the internet message id of the email being submitted. This information is present in the email header.
originalCategory submissionCategory The original category of the submission. The possible values are: notJunk, spam, phishing, malware and unkownFutureValue.
receivedDateTime DateTimeOffset Specifies the date and time stamp when the email was received.
recipientEmailAddress String Specifies the email address (in smtp format) of the recipient who received the email.
sender String Specifies the email address of the sender.
senderIP String Specifies the IP address of the sender.
subject String Specifies the subject of the email .
tenantAllowOrBlockListAction security.tenantAllowOrBlockListAction It is used to automatically add allows for the components such as URL, file, sender; which are deemed bad by Microsoft so that similar messages in the future can be allowed.

emailThreatSubmissionPolicy

Property Type Description
customizedNotificationSenderEmailAddress String Specifies the email address of the sender from which email notifications will be sent to end users to inform them whether an email is spam, phish or clean. The default value is null. Optional for creation.
customizedReportRecipientEmailAddress String Specifies the destination where the reported messages from end users will land whenever they report something as phish, junk or not junk. The default value is null. Optional for creation.
id String Only one id is supported. The default value is DefaultReportSubmissionPolicy.
isAlwaysReportEnabledForUsers Boolean Indicates whether end users can report a message as spam, phish or junk directly without a confirmation(popup). The default value is true. Optional for creation.
isAskMeEnabledForUsers Boolean Indicates whether end users can confirm using a popup before reporting messages as spam, phish or not junk. The default value is true. Optional for creation.
isCustomizedMessageEnabled Boolean Indicates whether the email notifications sent to end users to inform them if an email is phish, spam or junk is customized or not. The default value is false. Optional for creation.
isCustomizedMessageEnabledForPhishing Boolean If enabled, customized message only shows when email is reported as phishing. The default value is false. Optional for creation.
isCustomizedNotificationSenderEnabled Boolean Indicates whether to use the sender email address set using customizedNotificationSenderEmailAddress for sending email notifications to end users. The default value is false. Optional for creation.
isNeverReportEnabledForUsers Boolean Indicates whether end users can simply move the message from one folder to another based on the action of spam, phish or not junk without actually reporting it. The default value is true. Optional for creation.
isOrganizationBrandingEnabled Boolean Indicates whether the branding logo should be used in the email notifications sent to end users. The default value is false. Optional for creation.
isReportFromQuarantineEnabled Boolean Indicates whether end users can submit from the quarantine page. The default value is true. Optional for creation.
isReportToCustomizedEmailAddressEnabled Boolean Indicates whether emails reported by end users should be send to the custom mailbox configured using customizedReportRecipientEmailAddress. The default value is false. Optional for creation.
isReportToMicrosoftEnabled Boolean If enabled, the email will be sent to Microsoft for analysis. The default value is false. Required for creation.
isReviewEmailNotificationEnabled Boolean Indicates whether an email notification is sent to the end user who reported the email when it has been reviewed by the admin. The default value is false. Optional for creation.

fileThreatSubmission

Property Type Description
fileName String It specifies the file name to be submitted.

urlThreatSubmission

Property Type Description
webUrl String Denotes the webUrl that needs to be submitted.
In This Article
Back to top Created by merill | Submit feedback