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 *Requiredstring
Azure client ID
Application (client) ID of the Graph app registration
clientSecret *Requiredstring
Azure client secret
Client secret for the app registration; required for client-credentials flow
messageId *Requiredstring
Message ID
Graph message ID to retrieve
tenantId *Requiredstring
Azure tenant ID
Entra tenant (directory) ID used for Graph auth
includeAttachments booleanstring
falseInclude attachments
If true, returns attachment metadata; content is not downloaded here
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
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
