Microsoft 365 Get
CertifiedGet Outlook email message
Microsoft 365 Get
Get Outlook email message
Retrieves one email by message ID with optional attachments. Requires Microsoft Graph permission Mail.Read (application).
type: io.kestra.plugin.microsoft365.outlook.GetExamples
Get a specific email message
id: get_outlook_message
namespace: company.team
tasks:
- id: get_message
type: io.kestra.plugin.microsoft365.outlook.Get
tenantId: "{{ secret('AZURE_TENANT_ID') }}"
clientId: "{{ secret('AZURE_CLIENT_ID') }}"
clientSecret: "{{ secret('AZURE_CLIENT_SECRET') }}"
userPrincipalName: "user@example.com"
messageId: "AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e"
Get message from specific user mailbox
id: get_user_message
namespace: company.team
tasks:
- id: get_message
type: io.kestra.plugin.microsoft365.outlook.Get
tenantId: "{{ secret('AZURE_TENANT_ID') }}"
clientId: "{{ secret('AZURE_CLIENT_ID') }}"
clientSecret: "{{ secret('AZURE_CLIENT_SECRET') }}"
userPrincipalName: "user@example.com"
userEmail: "specific.user@example.com"
messageId: "{{ vars.messageId }}"
includeAttachments: true
Properties
clientId *string
Azure client ID
Application (client) ID of the Graph app registration
clientSecret *string
Azure client secret
Client secret for the app registration; required for client-credentials flow
messageId *string
Message ID
Graph message ID to retrieve
tenantId *string
Azure tenant ID
Entra tenant (directory) ID used for Graph auth
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150includeAttachments booleanstring
falseInclude attachments
If true, returns attachment metadata; content is not downloaded here
scopes string
https://graph.microsoft.com/.defaultScopes
Space-separated Graph scopes; default uses .default application permissions
userEmail string
User email
Mailbox to read; defaults to app mailbox when omitted
userPrincipalName string
User principal name
Mailbox UPN/email to act on; defaults to app context when omitted
Outputs
message
Message
Full message detail including recipients and attachments
io.kestra.plugin.microsoft365.outlook.domain.MessageDetail
io.kestra.plugin.microsoft365.outlook.domain.AttachmentInfo
date-timedate-time
