Outlook Mail

Configuration

Outlook Mail source connector integrates with the Microsoft Graph API to extract email data.

Synchronizes data from Outlook mailboxes.

It provides comprehensive access to mail folders, messages, and attachments with hierarchical folder organization and content processing capabilities.

View Source Code

Explore the Outlook Mail connector implementation

Authentication

This connector uses OAuth 2.0 authentication. Connect this source through the Airweave UI, which will guide you through the OAuth flow.

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

OutlookMailFolderEntity

Schema for an Outlook mail folder.

See: https://learn.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0

Field	Type	Description
display_name	str	Display name of the mail folder (e.g., ‘Inbox’).
parent_folder_id	Optional[str]	ID of the parent mail folder, if any.
child_folder_count	Optional[int]	Number of child mail folders under this folder.
total_item_count	Optional[int]	Total number of items (messages) in this folder.
unread_item_count	Optional[int]	Number of unread items in this folder.
well_known_name	Optional[str]	Well-known name of this folder if applicable (e.g., ‘inbox’).

OutlookMessageEntity

Schema for Outlook message entities.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0

Field	Type	Description
folder_name	str	Name of the folder containing this message
subject	Optional[str]	Subject line of the message
sender	Optional[str]	Email address of the sender
to_recipients	List[str]	Recipients of the message
cc_recipients	List[str]	CC recipients
sent_date	Optional[datetime]	Date the message was sent
received_date	Optional[datetime]	Date the message was received
body_preview	Optional[str]	Brief snippet of the message content
body_content	Optional[str]	Full message body content
is_read	bool	Whether the message has been read
is_draft	bool	Whether the message is a draft
importance	Optional[str]	Importance level (Low, Normal, High)
has_attachments	bool	Whether the message has attachments
internet_message_id	Optional[str]	Internet message ID

OutlookAttachmentEntity

Schema for Outlook attachment entities.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/fileattachment?view=graph-rest-1.0

Field	Type	Description
message_id	str	ID of the message this attachment belongs to
attachment_id	str	Outlook’s attachment ID
content_type	Optional[str]	Content type of the attachment
is_inline	bool	Whether this is an inline attachment
content_id	Optional[str]	Content ID for inline attachments
metadata	Dict[str, Any]	Additional metadata about the attachment