payload resource type
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents an attack simulation training payload in a tenant. A payload is the content (for example, message, links, and attachments) in a phishing email that is presented to users in an attack simulation training campaign.
Inherits from entity.
Methods
| Method | Return type | Description |
|---|---|---|
| List | payload collection | Get a list of attack simulation payload for a tenant. |
| Get | payload | Get an attack simulation payload for a tenant. |
| Get payload detail | payloadDetail | Get an attack simulation campaign payload detail for a tenant. |
Properties
| Property | Type | Description |
|---|---|---|
| brand | payloadBrand | The branch of a payload. Possible values are: unknown, other, americanExpress, capitalOne, dhl, docuSign, dropbox, facebook, firstAmerican, microsoft, netflix, scotiabank, sendGrid, stewartTitle, tesco, wellsFargo, syrinxCloud, adobe, teams, zoom, unknownFutureValue. |
| complexity | payloadComplexity | The complexity of a payload. Possible values are: unknown, low, medium, high, unknownFutureValue. |
| createdBy | emailIdentity | Identity of the user who created the attack simulation and training campaign payload. |
| createdDateTime | DateTimeOffset | Date and time when the attack simulation and training campaign payload. The timestamp represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| description | String | Description of the attack simulation and training campaign payload. |
| detail | payloadDetail | More details about the payload. |
| displayName | String | Display name of the attack simulation and training campaign payload. Supports $filter and $orderby. |
| id | String | Unique identifier for the attack simulation and training campaign payload. Inherited from entity. |
| industry | payloadIndustry | Industry of a payload. Possible values are: unknown, other, banking, businessServices, consumerServices, education, energy, construction, consulting, financialServices, government, hospitality, insurance, legal, courierServices, IT, healthcare, manufacturing, retail, telecom, realEstate, unknownFutureValue. |
| isAutomated | Boolean | Indicates whether the attack simulation and training campaign payload was created from an automation flow. Supports $filter and $orderby. |
| isControversial | Boolean | Indicates whether the payload is controversial. |
| isCurrentEvent | Boolean | Indicates whether the payload is from any recent event. |
| language | String | Payload language. |
| lastModifiedBy | emailIdentity | Identity of the user who most recently modified the attack simulation and training campaign payload. |
| lastModifiedDateTime | DateTimeOffset | Date and time when the attack simulation and training campaign payload was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| payloadTags | String collection | Free text tags for a payload. |
| platform | payloadDeliveryPlatform | The payload delivery platform for a simulation. Possible values are: unknown, sms, email, teams, unknownFutureValue. |
| predictedCompromiseRate | Double | Predicted probability for a payload to phish a targeted user. |
| simulationAttackType | simulationAttackType | Attack type of the attack simulation and training campaign. Supports $filter and $orderby. Possible values are: unknown, social, cloud, endpoint, unknownFutureValue. |
| source | simulationContentSource | Simulation content source. Supports $filter and $orderby. Possible values are: unknown, global, tenant, unknownFutureValue. |
| status | simulationContentStatus | Simulation content status. Supports $filter and $orderby. Possible values are: unknown, draft, ready, archive, delete, unknownFutureValue. |
| technique | simulationAttackTechnique | The social engineering technique used in the attack simulation and training campaign. Supports $filter and $orderby. Possible values are: unknown, credentialHarvesting, attachmentMalware, driveByUrl, linkInAttachment, linkToMalwareFile, unknownFutureValue, oAuthConsentGrant, phishTraining. You must use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: oAuthConsentGrant, phishTraining. For more information on the types of social engineering attack techniques, see simulations. |
| theme | payloadTheme | The theme of a payload. Possible values are: unknown, other, accountActivation, accountVerification, billing, cleanUpMail, controversial, documentReceived, expense, fax, financeReport, incomingMessages, invoice, itemReceived, loginAlert, mailReceived, password, payment, payroll, personalizedOffer, quarantine, remoteWork, reviewMessage, securityUpdate, serviceSuspended, signatureRequired, upgradeMailboxStorage, verifyMailbox, voicemail, advertisement, employeeEngagement, unknownFutureValue. |
payloadTheme values
| Member | Description |
|---|---|
| unknown | The payload theme isn't defined. |
| other | The payload is other. |
| accountActivation | Payload theme is of account activation. |
| accountVerification | Payload theme is of account verification. |
| billing | Payload theme is of billing type. |
| cleanUpMail | Payload mail cleanup details. |
| controversial | Payload controversial information. |
| documentReceived | Payload tells that the document has been received. |
| expense | Payload contains expense-related details. |
| fax | Payload contains fax-specific details. |
| financeReport | Payload contains a finance report. |
| incomingMessages | Payload contains details about incoming messages. |
| invoice | Payload contains invoice details. |
| itemReceived | Payload contains details about an item received. |
| loginAlert | Payload contains login alert information. |
| mailReceived | Payload contains information about a mail received. |
| password | Payload with password details. |
| payment | Payload with payment details. |
| payroll | Payload with payroll-specific details. |
| personalizedOffer | Payload with details about a personalized offer. |
| quarantine | Payload with quarantine-related details. |
| remoteWork | Payload related to as remote work. |
| reviewMessage | Payload with a review message request. |
| securityUpdate | Payload mentions that a security update is required. |
| serviceSuspended | Payload mentions that a service has been suspended. |
| signatureRequired | Payload tells that a signature is required. |
| upgradeMailboxStorage | Payload asks to upgrade the mailbox storage. |
| verifyMailbox | Payload asks for mailbox verification. |
| voicemail | Payload with voicemail details. |
| advertisement | Payload with advertisement details. |
| employeeEngagement | Payload with employee engagement details. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
payloadBrand values
| Member | Description |
|---|---|
| unknown | Payload brand as unknown. |
| other | Payload brand as other. |
| americanExpress | Payload brand as American Express. |
| capitalOne | Payload brand as Capital One. |
| dhl | Payload brand as DHL. |
| docuSign | Payload brand as DocuSign. |
| dropbox | Payload brand as Dropbox. |
| Payload brand as Facebook. | |
| firstAmerican | Payload brand as First American. |
| microsoft | Payload brand as Microsoft. |
| netflix | Payload brand as Netflix. |
| scotiabank | Payload brand as Scotiabank. |
| sendGrid | Payload brand as SendGrid. |
| stewartTitle | Payload brand as Stewart Title. |
| tesco | Payload brand as Tesco. |
| wellsFargo | Payload brand as Wells Fargo. |
| syrinxCloud | Payload brand as Syrinx Cloud. |
| adobe | Payload brand as Adobe. |
| teams | Payload brand as Teams. |
| zoom | Payload brand as Zoom. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
payloadIndustry values
| Member | Description |
|---|---|
| unknown | Payload industry as unknown. |
| other | Payload industry as other. |
| banking | Payload industry as banking. |
| businessServices | Payload industry as business services. |
| consumerServices | Payload industry as consumer services. |
| education | Payload industry as education. |
| energy | Payload industry as energy. |
| construction | Payload industry as construction. |
| consulting | Payload industry as consulting. |
| financialServices | Payload industry as financial services. |
| government | Payload industry as government. |
| hospitality | Payload industry as hospitality. |
| insurance | Payload industry as insurance. |
| legal | Payload industry as legal. |
| courierServices | Payload industry as courier services. |
| IT | Payload industry as IT. |
| healthcare | Payload industry as healthcare. |
| manufacturing | Payload industry as manufacturing. |
| retail | Payload industry as retail. |
| telecom | Payload industry as telecom. |
| realEstate | Payload industry as real estate. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
payloadComplexity values
| Member | Description |
|---|---|
| unknown | The payload complexity isn't defined. |
| low | The payload complexity is low. |
| medium | The payload complexity is medium. |
| high | The payload complexity is high. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
Relationships
None.
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.payload",
"brand": "String",
"complexity": "String",
"createdBy": {"@odata.type": "microsoft.graph.emailIdentity"},
"createdDateTime": "String (timestamp)",
"description": "String",
"detail": {"@odata.type": "microsoft.graph.payloadDetail"},
"displayName": "String",
"id": "String (identifier)",
"industry": "String",
"isAutomated": "Boolean",
"isControversial": "Boolean",
"isCurrentEvent": "Boolean",
"language": "String",
"lastModifiedBy": {"@odata.type": "microsoft.graph.emailIdentity"},
"lastModifiedDateTime": "String (timestamp)",
"payloadTags": ["String"],
"platform": "String",
"predictedCompromiseRate": "Double",
"simulationAttackType": "String",
"source": "String",
"status": "String",
"technique": "String",
"theme": "String"
}