-
Notifications
You must be signed in to change notification settings - Fork 5.5k
Description
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
Type
Projects
Status