Skip to main content

Microsoft Outlook

Type ID: microsoftOutlook  ·  Kind: Action  ·  Ports: 1 in, 1 out

Consume the Microsoft Outlook API: send mail and read messages for the authenticated user through Microsoft Graph.

Credentials​

Microsoft Outlook

Resources & operations​

  • Message (message)
    • Send (send) - Send a message.
    • Read All (readAll) - Read all messages.

Properties​

Common​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ResourceresourceoptionsNomessageMessage (message)-
OperationoperationoptionsNosendSend (send), Read All (readAll)resource = message

Message → Send​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
To (Recipients)toRecipientsstringYes''Comma-separated primary recipient email addressesresource = message, operation = send
Email SubjectsubjectstringNo''Free textresource = message, operation = send
MessagebodyContentstringNo''Free text (body content)resource = message, operation = send
Advanced Email OptionsadditionalFieldsobjectNo{}Collection (see below)resource = message, operation = send

additionalFields collection options:

PropertyKeyTypeRequiredDefaultPossible values
BCC (Hidden Recipients)bccRecipientsstringNo''Comma-separated email addresses
CC (Carbon Copy Recipients)ccRecipientsstringNo''Comma-separated email addresses
Body Content FormatbodyContentTypeoptionsNoTextHTML (html), Text (Text)
Reply-To AddressreplyTostringNo''Single email address
Store in Sent ItemssaveToSentItemsbooleanNotruetrue / false

Message → Read All​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
OutputoutputoptionsNosimpleSimplified (simple), Raw (raw), Select Included Fields (fields)resource = message, operation = readAll
LimitlimitnumberYes100Max number of resultsresource = message, operation = readAll
FieldsfieldscheckboxYes[]bccRecipients, body, bodyPreview, categories, ccRecipients, changeKey, conversationId, createdDateTime, flag, from, hasAttachments, importance, inferenceClassification, internetMessageId, isDeliveryReceiptRequested, isDraft, isRead, isReadReceiptRequested, lastModifiedDateTime, parentFolderId, receivedDateTime, replyTo, sender, sentDateTime, subject, toRecipients, webLinkresource = message, operation = readAll, output = fields
FiltersuserFiltersobjectNo{}Collection (see below)resource = message, operation = readAll

userFilters collection options:

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Filter ByfilterByoptionsNofiltersFilters (filters), Search (search)-
SearchsearchstringNo''Free-text search queryfilterBy = search
FiltersfiltersobjectNo{}Nested collection (see below)filterBy = filters

userFilters.filters nested collection options:

PropertyKeyTypeRequiredDefaultPossible values
Read StatusreadStatusoptionsNounreadUnread and read messages (both), Unread messages only (unread), Read messages only (read)
Received AfterreceivedAfterdateTimeNo''ISO date string or millisecond timestamp
Received BeforereceivedBeforedateTimeNo''ISO date string or millisecond timestamp
SendersenderstringNo''Sender name or email

Notes​

  • To (Recipients) is required for Send; Limit is required for Read All; Fields is required when Output = Select Included Fields.
  • Send output: { success: true } (no message details are returned).
  • Read All output: { success, data: [...] }. With Output = Simplified, only id, conversationId, subject, bodyPreview, from, toRecipients, categories, hasAttachments are returned per message.