Skip to content

[ENHANCEMENT] Microsoft Outlook: New Attachment Received & Download Attachment #16270

@dannyroosevelt

Description

@dannyroosevelt

Potentially model it off of Gmail New Attachment Received trigger — how is the attachment returned? Via a publicly accessible url? Or a file you need to download to tmp to process?


Source: New Attachment Received

Triggers a workflow when a new email containing one or more attachments arrives in a specified Microsoft Outlook folder. Emits an event for each attachment found.

Props:

Prop Type Description API Mapping / Concept
folderId string Optional. The ID of the folder to monitor. Defaults to the Inbox. mailFolders/{folder-id} segment in API subscription/polling target
timer object Optional. Configure the polling interval if using polling trigger. Not applicable for instant (webhook) trigger. Polling frequency / Webhook subscription (changeNotifications)

Output / Emitted Data:

The source emits an object for each attachment, containing details like:

  • attachmentId: The unique ID of the attachment.
  • messageId: The unique ID of the message the attachment belongs to.
  • name: The filename of the attachment.
  • contentType: The MIME type of the attachment (e.g., "application/pdf").
  • size: The size of the attachment in bytes.
  • isInline: Whether the attachment is intended to be displayed inline.
  • messageSubject: The subject of the email message.
  • messageSender: Information about the sender of the email.
  • messageReceivedDateTime: When the email was received.

Note: This source typically relies on Microsoft Graph change notifications (webhooks) for near real-time triggering or periodic polling of the specified folder, filtering for messages where hasAttachments is true. It then fetches attachment details for new messages.

API Document:


Action: Download Attachment

Retrieves the raw content of a specific email attachment from Microsoft Outlook using its Message ID and Attachment ID.

Props:

Prop Type Description API Mapping
messageId string The ID of the message containing the attachment. {message-id} segment in the API path
attachmentId string The ID of the attachment to download. {attachment-id} segment in the API path
filePath string The path to tmp dir

Output:

Returns an object containing:

  • fileName: The original filename of the attachment.
  • contentType: The MIME type of the attachment.
  • filePath: A temp file path within the Pipedream execution environment where the content is stored.

Note: This action primarily uses the GET /messages/{message-id}/attachments/{attachment-id}/$value endpoint to retrieve the raw attachment data. For file attachments, it might alternatively retrieve the contentBytes property from the standard GET /messages/{message-id}/attachments/{attachment-id} endpoint if the attachment is small (under 3MB), but using /$value is more general.

API Document: Get attachment (including raw content via $value)

Metadata

Metadata

Assignees

Labels

enhancementNew feature or requestgood first issueGood for newcomershelp wantedExtra attention is neededtriagedFor maintainers: This issue has been triaged by a Pipedream employeetrigger / sourceNew trigger / source request

Type

No type

Projects

Status

Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions